This lab is currently in Beta, content may be updated as we refine the material
LABBEGINNER

Worker Tags and Egress Filters

On a three-VM Community Edition 0.21.3 cluster, inspect east and west worker tags, break a TCP session with a bad egress filter, then pin egress to the west-tagged worker.

45 minutes
hashicorp/boundary
Worker Tags and Egress Filters - Platform Engineering Hands-On Lab Icon
Share this Lab

Lab Overview

This is the hands-on lab for Section 11 of the Boundary 101 course. Setup already brought up a controller plus PostgreSQL-16 on one VM and two worker-led workers on the others: worker-east tagged region=["east"] and worker-west tagged region=["west"]. A TCP target already points at the worker-west routable IP on port 22. You do not write HCL, init the database, or register the workers.

You will:

  • List and read both workers, confirm tag values are arrays, and save

the east and west worker IDs

  • Set an egress_worker_filter that matches no worker (for example

"south" in "/tags/region"), then prove authorize-session fails with the no-workers placement error (CE 0.21.3: 500 Internal)

  • Update the same target to "west" in "/tags/region" and connect with

the boundary connect ssh helper through the west-tagged worker

  • Read the target and confirm ingress_worker_filter is unset (that

attribute is HCP and Enterprise, not Community Edition)

Targets stay TCP (ttcp_*). boundary connect ssh is a helper, not an SSH target type. The target address must stay the worker-west IP from /opt/tekanaid/vm_ips.txt, never 127.0.0.1. Do not set ingress_worker_filter. Do not set a Vault worker_filter.

What You'll Learn

Inspect registered workers and confirm canonical region tags are arrays (east on worker-east, west on worker-west)

Set an egress_worker_filter that matches no worker and capture the no-workers placement error (CE 0.21.3: 500 Internal)

Set egress_worker_filter to "west" in "/tags/region" so the west-tagged worker brokers a TCP session to the west VM IP

Confirm the TCP target has no ingress_worker_filter (HCP and Enterprise only)

Prerequisites

Completion of the Boundary 101 Section 11 (Workers, Tags, and Filters) lessons

Familiarity with the Boundary CLI from Labs 1 through 3 (authenticate, -keyring-type=none, TCP targets, worker-led register)

Basic Linux command line

Technologies Covered

boundaryworkerstagsegress-worker-filtertcp-targetauthorize-sessionworker-aware-targets

Choose your plan

Simple, Transparent Pricing

Unlock full access to TeKanAid courses, labs, and bootcamps

Buying for a team? Private corporate training is available for up to 15 learners.View team training
MonthlyQuarterly
Try Premium free for 7 days →

Just exploring? Start free below. Want the full experience? Try Premium free for 7 days (card required, $0 today).

Pro

All courses, with lab scripts to run on your own machine

$59/month

Renews automatically. Cancel anytime.

Final price verified at checkout.

  • Full access to all courses
  • Lab scripts to download and run on your own machine (hosted labs not included)
  • Progress tracking
  • Certificate of completion
  • Community access
  • Self-paced bootcamps
  • Premium puzzle library not included (5 free puzzles available)
  • New content access
Recommended

Premium

Full access, including unlimited hosted labs

$99/month

Renews automatically. Cancel anytime.

Final price verified at checkout.

  • Everything in Pro
  • Unlimited hands-on labs, fully hosted on TeKanAid Academy (nothing to set up)
  • Full access to the puzzle library
  • Lab AI Assistant
  • Priority support

Prefer a single course?

Purchase individual courses for a one-time fee of $79. Full access to course content, quizzes, certificates, and community features, lab access is not included.

Browse Courses

Just exploring? Start free, no account needed

Three free ways to start. All bridge into the paid Premium catalog when you're ready.

Not ready to commit? The crash course is email-only. No academy account required.

Ready to Get Started?

Start this hands-on lab and build real-world Platform Engineering skills

Get Access Now