Merge pull request #96 from OpenConext/fix/local-domain-dns-delay

fix: avoid macOS mDNS 5s delay on .local hosts entries

Author: pmeulen

core/README.md

@@ -34,7 +34,11 @@ You will also need to tell your local machine where to find the hosts.
 Add the following line in your hosts file (/etc/hosts):
 ```
 127.0.0.1 engine.dev.openconext.local manage.dev.openconext.local profile.dev.openconext.local engine-api.dev.openconext.local mujina-idp.dev.openconext.local profile.dev.openconext.local connect.dev.openconext.local teams.dev.openconext.local voot.dev.openconext.local pdp.dev.openconext.local invite.dev.openconext.local welcome.dev.openconext.local
+::1 engine.dev.openconext.local manage.dev.openconext.local profile.dev.openconext.local engine-api.dev.openconext.local mujina-idp.dev.openconext.local profile.dev.openconext.local connect.dev.openconext.local teams.dev.openconext.local voot.dev.openconext.local pdp.dev.openconext.local invite.dev.openconext.local welcome.dev.openconext.local
 ```
+The `::1` line matters on macOS: without a local AAAA (IPv6) record,
+`.local` hostname lookups fall through to multicast DNS (Bonjour),
+which takes ~5s to time out before falling back to /etc/hosts.
 
 If all goes well, you can now login. Please see the section below to find out where you can login.
 

core/scripts/init.sh

@@ -128,7 +128,11 @@ printf "\n"
 echo -e "${BLUE}Please add the following line to your /etc/hosts: ${VINKJE}"
 printf "\n"
 
+# The ::1 line avoids macOS's ~5s mDNS/Bonjour timeout for .local hostnames --
+# without a local AAAA (IPv6) record, macOS tries multicast DNS first for
+# every .local lookup before falling back to /etc/hosts.
 echo "127.0.0.1 engine.dev.openconext.local manage.dev.openconext.local profile.dev.openconext.local engine-api.dev.openconext.local mujina-idp.dev.openconext.local profile.dev.openconext.local connect.dev.openconext.local teams.dev.openconext.local voot.dev.openconext.local invite.dev.openconext.local welcome.dev.openconext.local"
+echo "::1 engine.dev.openconext.local manage.dev.openconext.local profile.dev.openconext.local engine-api.dev.openconext.local mujina-idp.dev.openconext.local profile.dev.openconext.local connect.dev.openconext.local teams.dev.openconext.local voot.dev.openconext.local invite.dev.openconext.local welcome.dev.openconext.local"
 
 printf "\n"
 echo "You can now login. If you want to bring the environment down, use the command below"

stepup/README.md

@@ -19,7 +19,11 @@ First, you need to create an entry in your hosts file (/etc/hosts on *nix system
 
 ```
 127.0.0.1 selfservice.dev.openconext.local ssp.dev.openconext.local gateway.dev.openconext.local middleware.dev.openconext.local ra.dev.openconext.local demogssp.dev.openconext.local tiqr.dev.openconext.local webauthn.dev.openconext.local azuremfa.dev.openconext.local
+::1 selfservice.dev.openconext.local ssp.dev.openconext.local gateway.dev.openconext.local middleware.dev.openconext.local ra.dev.openconext.local demogssp.dev.openconext.local tiqr.dev.openconext.local webauthn.dev.openconext.local azuremfa.dev.openconext.local
 ```
+The `::1` line matters on macOS: without a local AAAA (IPv6) record,
+`.local` hostname lookups fall through to multicast DNS (Bonjour),
+which takes ~5s to time out before falling back to /etc/hosts.
 
 Secondly you need to create the `stepup/gateway/surfnet_yubikey.yaml` file with your Yubikey API credentials.
 If you do not have API credentials, you can get them at <https://upgrade.yubico.com/getapikey/>.