Skip to content

アクセス制御 ​

アクセスは distribution の設定です。変更はライブのサイトにすぐ適用されます。デプロイメントは作成しません。

モード ​

保存されるモード訪問者に見えるもの
publicゲートのないサイト
loginサインインページ。方式は password、deca、email_code、email_link です
password以前のパスワードゲートの書き方。新しい書き込みは login として保存されます

"mode": "password" を送ると、"mode": "login" と "methods": ["password"] が保存されます。方式がパスワードだけのとき、require_mfa は設定できません。エラーコードは ACCESS_MFA_WITH_PASSWORD です。

session_ttl は 1h から 24h です。既定は 8h です。

ルール ​

ルールは、あとから誰がサインインできるかを決めます。共有パスワードには適用されません。

種類値
email1 つのアドレス
email_domainドメイン。先頭の @ はあってもなくてもよい
any_signed_inサインインした人なら誰でも。値は空
deca_memberこの組織の DECA アカウントでサインインした人。値は空。roles と namespaces は任意で、両方空ならメンバー全員が対象。別の組織の人は一致しない。edge access rules add では --role と --namespace を繰り返す。API では roles と namespaces の配列を送る。

applies_to は live、preview、both です。

1 つの distribution には 200 件までです。1 つのワークスペースには 500 件までです。超えると ACCESS_RULE_LIMIT が返ります。

ネットワークルール ​

ネットワークルールは、サインインより前に、どのネットワークから distribution に届くかを決めます。上のアクセスルールとは別のもので、サインインしているかどうかに関係なく、すべての訪問者に適用されます。手順は IP アドレスや国でアクセスを制限する を参照してください。

種類値
ip_allowIPv4 または IPv6 のアドレスか範囲。203.0.113.0/24、2001:db8:1::/48。範囲のないアドレスは /32 または /128
ip_block同上
country_allowJP のような ISO 3166-1 alpha-2 のコード
country_block同上

ルールは 1 つの distribution に属するか、distribution を指定せずに作るとワークスペースに属します。distribution では、自分のルールとワークスペースのルールが一緒に使われます。applies_to は live、preview、both で、既定は both です。note は 200 文字までの任意のメモです。

ホスト部が 0 でない範囲(10.1.2.3/8)と、IPv4 で /8、IPv6 で /16 より広い範囲は、ほぼ確実に間違いなので受け付けません。

評価順 ​

Edge はリクエストを次の順に確認し、最初に当てはまったところで止まります。

  1. アドレスがブロック範囲に入っている: 403。
  2. アドレスが許可範囲に入っている: 通す。国のルールは確認しない。
  3. 国がブロックされている: 403。
  4. IP の許可リストがあり、アドレスが入っていない: 許可されない。
  5. 国の許可リストがあり、国が入っていない: 許可されない。
  6. 国が許可されている: 通す。
  7. 当てはまるルールがない: 通す。

Edge が国を判別できない訪問者は、どの国のルールにも一致しません。「許可されない」は 403 です。ただし下の login_fallback では違います。/_hooks は許可リストを無視します。プロバイダーは自分のネットワークから呼び出すためです。ブロックのルールは /_hooks にも適用されます。

サインインとの組み合わせ ​

network_mode は、ネットワークルールとサインインの組み合わせ方を決めます。distribution の設定で、PUT /v1/distributions/{id}/access/network-mode で変えます。

network_mode許可された訪問者許可されないブロック
enforce(既定)サイトが必要とするならサインイン403403
login_fallbackサインインを省くサインイン403

login_fallback が効くのは、サインインが必要なサイトだけです。公開サイトでは enforce と同じ動きになります。

拒否ページと確認用ホスト ​

拒否された訪問者には、英語と日本語の 403 ページが no-store と noindex 付きで返り、Edge が見たアドレスと国が表示されます。https://ip.edge.deca-dev.com/ は、開いた人の同じ値を JSON で返します。?format=text を付けるとテキストで返します。ネットワークルールが見るのも同じアドレスです。

ルールと network_mode の変更は数秒で反映されます。どちらもデプロイメントを作らず、切り戻しでも変わりません。caller_ip を付けて ip_allow ルールを作るとき、そのアドレスが拒否されることになるなら、confirm が true でない限り NETWORK_SELF_LOCKOUT で失敗します。

セッション ​

全員をサインアウトすると、cookie の鍵が変わります。1 つの sub は、そのセッションが切れるはずだった時刻まで記録されます。1 つの distribution には 1,000 件までです(ACCESS_REVOCATION_LIMIT)。

アクセスを弱める ​

ログインを外す、require_mfa を外す、方式を減らす、にはアクセスを変える権限が必要です。権限がないと 403 ACCESS_DOWNGRADE になり、メッセージは対象のフィールド名を含みます。config.access を付けてデプロイメントを作成したときと、デプロイメントを切り戻したときも、同じ確認が走ります。

HTTP API、MCP、CLI を参照してください。