Secure ingresses

To secure unwanted access (for example, on /magnolia/.admincentral or similar) and to avoid crawlers accessing unpublished content, it’s usually a good idea to work with IP Whitelisting on Ingress-Nginx and Robots-Tags (such as X-Robots-Tag:noindex, nofollow).


  1. First ensure you are connected to your Magnolia PaaS Kubernetes Cluster using the correct kubeconfig.

  2. Create an HTPASSWD file.

    # Create HTPASSWD File
    $ htpasswd -c auth myadmin
    New password:
    Re-type new password:
    Adding password for user myadmin
  3. Convert to a Kubernetes secret.

    $ kubectl create -n dev secret generic basic-auth --from-file=auth
    secret/basic-auth created
  4. Annotate on the ingress and add whitelisting.

    $ kubectl edit -n prod ingress myingress
  5. Create the annotation template to update the ingress.

    $  k annotate -n dev ingress --overwrite=true dev-magnolia-helm \"PLEASE LOGIN:" \ \ \'more_set_headers "X-Robots-Tag: noindex, nofollow";' \  (1)",2a03:4000:6:b665::46/128,,,,,,,,,,,,,,,,,,," \           (2)
    1 Set the robot tags for crawler information. Only use the `configuration-snippet` exactly as instructed. Otherwise, you may cause issues with your PaaS deployment.
    2 Set the IP whitelisting for IPv4/v6 IPs and Subnets. To test before deployment, you can leave this out during a dry run (Subnets—​dry-run=client).

    The following IPs must be whitelisted for Fastly to work properly. The example above includes these IPs, so feel free to copy those.,,,,,,,,,,,,,,,,,,
  6. Run a remote --dry-run=client if fine and apply it.

    $ k get ingress -n dev dev-magnolia-helm -o yaml
    kind: Ingress
      annotations: letsencrypt-prod '[{"addresses":[""],"port":443,"protocol":"HTTPS","serviceName":"dev:dev-magnolia-helm-public-svc","ingressName":"dev:dev-magnolia-helm","hostname":"","path":"/","allNodes":false},{"addresses":[""],"port":443,"protocol":"HTTPS","serviceName":"dev:dev-magnolia-helm-author-svc","ingressName":"dev:dev-magnolia-helm","hostname":"","path":"/author","allNodes":false}]' nginx dev dev 'PLEASE LOGIN:' basic-auth basic 'more_set_headers "X-Robots-Tag: noindex, nofollow";' (1) 512m",2a03:4000:6:b665::46/128,,,,,,,,,,,,,,,,,,,"
    1 Only use the `configuration-snippet` exactly as instructed. Otherwise, you may cause issues with your PaaS deployment.

Test Basic Auth and Whitelisting

  1. Run the following command:

    $ curl
    $ curl
    <head><title>403 Forbidden</title></head>
    <center><h1>403 Forbidden</h1></center>

Require authentication from permitted IP range

  1. Run the following command:

    $ curl
    $ curl
    <head><title>401 Authorization Required</title></head>
    <center><h1>401 Authorization Required</h1></center>
  2. Authenticate via Basic Auth using your stored credentials:

    $ curl -u myadmin:myadmin

    Verbose output

    $ curl -v -H 'Host:' -u myadmin:myadmin
    *   Trying
    * Connected to ( port 443 (#0)
    * ALPN: offers h2
    * ALPN: offers http/1.1
    *  CAfile: /etc/ssl/cert.pem
    *  CApath: none
    * (304) (OUT), TLS handshake, Client hello (1):
    * (304) (IN), TLS handshake, Server hello (2):
    * (304) (IN), TLS handshake, Unknown (8):
    * (304) (IN), TLS handshake, Certificate (11):
    * (304) (IN), TLS handshake, CERT verify (15):
    * (304) (IN), TLS handshake, Finished (20):
    * (304) (OUT), TLS handshake, Finished (20):
    * SSL connection using TLSv1.3 / AEAD-AES256-GCM-SHA384
    * ALPN: server accepted h2
    * Server certificate:
    *  subject:
    *  start date: Oct 26 12:57:00 2022 GMT
    *  expire date: Jan 24 12:56:59 2023 GMT
    *  subjectAltName: host "" matched cert's ""
    *  issuer: C=US; O=Let's Encrypt; CN=R3
    *  SSL certificate verify ok.
    * Using HTTP2, server supports multiplexing
    * Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0
    * Server auth using Basic with user 'myadmin'
    * h2h3 [:method: GET]
    * h2h3 [:path: /]
    * h2h3 [:scheme: https]
    * h2h3 [:authority:]
    * h2h3 [authorization: Basic bXlhZG1pbjpteWFkbWlu]
    * h2h3 [user-agent: curl/7.84.0]
    * h2h3 [accept: */*]
    * Using Stream ID: 1 (easy handle 0x156811400)
    > GET / HTTP/2
    > Host:
    > authorization: Basic bXlhZG1pbjpteWFkbWlu                             # Basic Auth active!
    > user-agent: curl/7.84.0
    > accept: */*
    * Connection state changed (MAX_CONCURRENT_STREAMS == 128)!
    < HTTP/2 302
    < date: Thu, 01 Dec 2022 08:47:20 GMT
    < content-length: 0
    < set-cookie: JSESSIONID=E70616BACA0156F20E6A54A445181E59; Path=/; Secure; HttpOnly
    < set-cookie: csrf=55JCyz9SNh5mdE7Ke7k1cgkBX9e6huRpCUyj47GPjzM
    < x-magnolia-registration: Registered
    < location: /travel.html;jsessionid=E70616BACA0156F20E6A54A445181E59
    < strict-transport-security: max-age=15724800; includeSubDomains
    < x-robots-tag: noindex, nofollow (1)
    * Connection #0 to host left intact
    1 x-robots-tags are set and delivered.

    Verify the Output for x-robots-tag: noindex, nofollow.





This widget lets you know where you are on the docs site.

You are currently perusing through the Magnolia PaaS docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules