tailnetポリシーファイル

tailnetのパラメーター・ポリシー・設定を格納する構成ファイル

最終検証日：2025年5月21日
翻訳: 竹洞 陽一郎

tailnetポリシーファイルは、Tailscaleネットワーク（tailnetと呼ばれます）のパラメーター、ポリシー、設定を格納する、一元化されたHuJSON（human JSON）形式の構成ファイルです。
Owner、Admin、Network adminのロールを持つユーザーは、Tailscale管理コンソールからtailnetポリシーファイルを管理できます。
また、GitHub、GitLab、Bitbucketを使ったGitOpsでtailnetポリシーファイルを管理することもできます。

tailnetポリシーファイルは、複数のトップレベルセクションで構成されており、それぞれが異なる機能を提供します。
tailnetポリシーファイルのさまざまなセクションを使って、以下のようなことができます。

• タグ（tags）、グループ、IPセット（IP sets）を使って、ユーザー、デバイス、ネットワークセグメントの名前付きグループを定義します。
• ACLを使って、ネットワーク層でのアクセス制御ポリシーを定義します。
• グラントを使って、ネットワーク層とアプリケーション層でのアクセス制御ポリシーを定義します。
• IPアドレスとサブネットにエイリアスを割り当てます（hostsセクションを使用）。
• デバイスポスチャ（device posture）ルールを定義します。
• 誰がTailscale SSHを利用できるかを指定します。
• 誰がどのタグを使ってデバイスを認証できるかを指定します。
• 誰がサブネットルーターやExit Nodeをアドバタイズする際の承認プロセスをバイパスできるかを指定します。
• ノード属性（node attributes）と呼ばれる追加の属性をデバイスとユーザーに適用します。
• 変更されるべきではないアクセス制御ポリシー（ACLとTailscale SSH）についてアサーションを行うテストを記述します。
• tailnet全体のポリシーオプションを定義します（IPv4の無効化など）。

tailnetポリシーファイルの各セクションを組み合わせて使うことで、tailnetをモジュール式かつきめ細かく管理できます。
例えば、カスタムグループのユーザーを定義し、続いてそのグループのユーザーがtailnet内のリソースをどのように通過できるかを指定するアクセス制御ポリシーを作成できます。

セクション

次の表は、tailnetポリシーファイルの各トップレベルセクションの概要です。

IPv4の無効化やDERPマップのカスタマイズなど、ネットワークポリシーオプション用の追加セクションもあります。
ほとんどの場合、これらの設定は不要です。