Join our Newsletter — 33% off our NHI Course

Do mTLS and roles fully govern Terraform as an NHI client?

 

(@nhi-mgmt-group)
Member Moderator
Joined: 2 years ago
Posts: 20225
Topic starter  

TL;DR: Teleport's analysis of API architecture finds its gRPC API governs clients such as tctl, Terraform and the Kubernetes operator with mTLS, user-bound certificates and minimum-permission roles. Practitioners need to bind each automation client to a unique identity and rotation-aware credential model so the real blast radius stays small.

Editorial analysis by NHI Mgmt Group, based on content published by Teleport: “API Architecture”.

Key questions

Q: Why do client certificates and mTLS still need lifecycle governance?

A: Because authentication only proves the caller once.

Q: What breaks when multiple automation tools share one API identity?

A: Attribution and privilege control degrade quickly.

Q: How should teams govern API clients that manage infrastructure like NHIs?

A: Give each client its own identity, role and credential lifecycle.

Practitioner guidance

  • Create a distinct identity for every API client Assign each automation or tooling client its own user and role so permissions, logs and access reviews map to one caller instead of a shared automation account.
  • Enforce mTLS for non-human API access Require certificates signed by the Auth Service for all clients that manage cluster resources, and treat certificate issuance as part of the access model.
  • Scope client roles to the minimum read or write action Build roles from the exact API operations a client needs, then avoid broad built-in roles when a narrower policy will do.

Bottom line: Teleport’s API model shows that automation clients need explicit identity governance, not borrowed trust from the systems they control.

Glossary terms: Non-Human Identity (NHI), mTLS, Credential Loader, Least Privilege

What's in the full article

Teleport's full guide covers the operational detail this post intentionally leaves for the source:

  • Step-by-step role and user configuration examples for API clients that manage Teleport resources
  • Credential loader comparisons that help teams choose between profile, identity file, dynamic identity file and TLS approaches
  • Connection setup details for clients that reach the Auth Service directly or through a reverse tunnel
  • Production hardening guidance for running Teleport services and clients with minimal privileges

👉 Read Teleport's guide to governing gRPC API clients as non-human identities →

Explore further

View Full Forum →  |  NHI Foundation Course →  |  Our Services →  |  Read the full analysis →


This topic was modified 1 week ago by NHI Mgmt Group

   
Quote
(@mr-nhi)
Member Moderator
Joined: 6 months ago
Posts: 20715
 

NHI clients need first-class governance, not inherited trust: Teleport’s API pattern shows that tooling identities such as Terraform providers and Kubernetes operators behave like durable machine actors, not transient request headers. Once a client can manage cluster resources, it has governance significance regardless of whether a human triggered it. The implication is that identity programmes must inventory API clients as NHIs and assign them explicit lifecycle ownership.

A question worth separating out:

Q: Should teams use dynamic identity files for long-running machine clients?

A: Yes, when the client must stay online while credentials rotate. Reloadable identity files reduce manual intervention and help continuous workloads keep access aligned to current credentials, provided the underlying issuance and revocation process is still tightly governed.

👉 Read our full editorial: gRPC API clients need distinct identity and rotation controls


This post was modified 1 week ago by NHI Mgmt Group

   
ReplyQuote
Share:

Free weekly newsletter

Subscribe to the NHI & AI Identity Journal

The latest on NHI and Agentic AI security – articles, research, breaches, news and events every week.

Bonus 33% off our NHI Course when you subscribe.