Skip to content

docs: add IP restriction guide (organization, folder, application)#130

Merged
anukiransolur merged 1 commit into
mainfrom
docs/ip-restriction
Jun 8, 2026
Merged

docs: add IP restriction guide (organization, folder, application)#130
anukiransolur merged 1 commit into
mainfrom
docs/ip-restriction

Conversation

@jackchuka

Copy link
Copy Markdown
Member

Summary

Adds a new IP Restriction guide under Administration documenting how to restrict access by client IP across the account hierarchy. This was previously only discoverable in the Terraform provider registry, not on docs.tailor.tech.

Covers all three layers:

Layer Mechanism Scope
Organization tailor_organization_ip_restriction (Terraform, provider >= 2.16.0) all workspaces in the org
Folder tailor_organization_folder_ip_restriction (Terraform, provider >= 2.16.0) all workspaces in a folder
Application AllowedIPAddresses (app manifest) a single application

The layers compose with AND — a request must satisfy every configured layer. This is sourced from the provider docs.

Changes

  • New: docs/administration/ip-restriction.md — guide with HCL examples and argument tables for the org- and folder-level resources, plus the layering/AND-composition explanation.
  • docs/administration/index.md — link the new page from the Administration index.
  • docs/guides/application.md — cross-link from the existing AllowedIPAddresses entry.

Verification

  • pnpm lint ✅ (no new issues)
  • pnpm build ✅ (page renders, in sitemap)
  • schema-check (mdschema) ✅
  • oxfmt on the new file ✅

Note for reviewers

The provider docs state AND composition explicitly for organization + folder. The guide extends "applies on top of" to the application layer as well — the consistent reading, but not verbatim in the source docs. Please confirm application-level composition behaves the same before merge.

Document the organization- and folder-level IP allowlist Terraform
resources (tailor_organization_ip_restriction,
tailor_organization_folder_ip_restriction, provider >= 2.16.0) alongside
the existing application-level AllowedIPAddresses setting, and explain
their AND composition. Cross-link from the application guide and the
administration index.
@jackchuka
jackchuka marked this pull request as ready for review June 8, 2026 08:20
@jackchuka
jackchuka requested a review from a team as a code owner June 8, 2026 08:20
@anukiransolur
anukiransolur merged commit 61f5c66 into main Jun 8, 2026
7 of 9 checks passed
@anukiransolur
anukiransolur deleted the docs/ip-restriction branch June 8, 2026 22:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants