アクセス制御
アクセスは 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 です。
ルール
ルールは、あとから誰がサインインできるかを決めます。共有パスワードには適用されません。
| 種類 | 値 |
|---|---|
email | 1 つのアドレス |
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_allow | IPv4 または IPv6 のアドレスか範囲。203.0.113.0/24、2001:db8:1::/48。範囲のないアドレスは /32 または /128 |
ip_block | 同上 |
country_allow | JP のような 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 はリクエストを次の順に確認し、最初に当てはまったところで止まります。
- アドレスがブロック範囲に入っている: 403。
- アドレスが許可範囲に入っている: 通す。国のルールは確認しない。
- 国がブロックされている: 403。
- IP の許可リストがあり、アドレスが入っていない: 許可されない。
- 国の許可リストがあり、国が入っていない: 許可されない。
- 国が許可されている: 通す。
- 当てはまるルールがない: 通す。
Edge が国を判別できない訪問者は、どの国のルールにも一致しません。「許可されない」は 403 です。ただし下の login_fallback では違います。/_hooks は許可リストを無視します。プロバイダーは自分のネットワークから呼び出すためです。ブロックのルールは /_hooks にも適用されます。
サインインとの組み合わせ
network_mode は、ネットワークルールとサインインの組み合わせ方を決めます。distribution の設定で、PUT /v1/distributions/{id}/access/network-mode で変えます。
network_mode | 許可された訪問者 | 許可されない | ブロック |
|---|---|---|---|
enforce(既定) | サイトが必要とするならサインイン | 403 | 403 |
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 を付けてデプロイメントを作成したときと、デプロイメントを切り戻したときも、同じ確認が走ります。