Access Policy のスケジュール
このページの内容
時間は、すべての Access Policy の When の部分です。Anytime または Scheduled を選択します。スケジュールが設定されたポリシーには、1 つ以上の Weekly または One-time の時間枠が含まれます。Settings → Access Time Windows ページについては、猶予期間とタイムゾーンを参照してください。
1 つのポリシーがアクセスを許可するのは、Who AND Where AND When が一致した場合のみです。1 つのポリシー内の時間枠は OR で結合され、名前付きのポリシー同士も OR で結合されます。ポリシーは許可専用です。非アクティブなポリシーによって、一致する別のポリシー、恒久的な付与、または別の管理者や連携サービスの時間枠からのアクセスが取り消されることはありません。
常時
Anytime は、ポリシーの Who と Where がスケジュールの制限なしに一致できることを意味します。安全性、メンテナンス、ジオフェンス、ブロック、レート制限、デバイスのチェックが省略されるわけではありません。
Weekly の時間枠
Weekly の時間枠は、Monday 06:00–08:30 などの現地の時刻のブロックを使用して繰り返されます。
- 選択した IANA タイムゾーンによって、曜日、現地時刻、夏時間の動作が決まります。
- 任意の開始時点（active-from）と終了時点（active-until）で繰り返しの期間を限定できます。終了時点は含まれません。
- ブロックを重複させたり、深夜 0 時をまたいだりすることはできません。夜間をまたぐ期間は 2 日に分けてください。
- 夏時間の開始時には、スキップされた現地時刻は発生しません。夏時間の終了時には、繰り返される現地時刻が表す実際の 2 つの時点の両方が該当します。
One-time の時間枠
One-time の時間枠には、正確な開始時点と終了時点が 1 つずつあります。既知の単発の期間に使用します。
- 開始と終了は、UTC の時点を表す整数の Unix 秒です。
- 境界は半開区間
[from, to)です。開始時点は該当し、終了時点は該当しません。 - 表示されるタイムゾーンは、入力、表示、監査のためのものです。保存された時点が変わることはありません。
個別のユーザーと連携サービスの時間枠
管理者が所有するユーザーの時間枠と、連携サービスが提供する時間枠は、引き続き別の追加の経路として機能します。Access Policies に変換されることはなく、ポリシーを編集しても削除できません。それぞれ独自の取り決めに従って、施設、ドア、または Access Scopes を対象にできます。
連携サービスの時間枠では、ソースの所有権、リビジョン、鮮度、scope_key のマッピングの動作が保持されます。不明、無効、マッピングなし、古い、または切り離されたソースの時間枠では、アクセスは許可されません。あるソースが別のソースの時間枠を消去することはできず、ソースの更新やポリシーの編集によって管理者が所有する時間枠が消去されることもありません。
恒久的な付与も、別の追加の経路です。その既存の任意の営業時間は、ポリシーのスケジュールとは独立しています。
猶予期間とタイムゾーン
図 1：Settings → Access Time Windows → Access grace periods
Settings → Access Time Windows → Access grace periods では、スケジュールされた時間枠の前後にどれだけの余裕を持たせるかを設定します。"Scheduled start and end times remain unchanged. These buffers only expand when door access is allowed."
- Facility timezone：Weekly の時間枠で使用するタイムゾーンで、夏時間の変更に自動的に従います。変更するには Change timezone in Facility & System Configuration を使用します。タイムゾーンを参照してください。
- Allow early access："Allow users to unlock doors shortly before their scheduled window starts." Off、5 minutes、10 minutes、15 minutes、または 30 minutes。
- Allow access after end："Keep door access available briefly after the scheduled window ends." Off、5 minutes、10 minutes、15 minutes、または 30 minutes。
猶予期間は、予約サービスとの連携によって提供される時間枠を含め、施設のすべての One-time と Weekly の時間枠に適用されます。No visit recorded にも反映され、猶予期間中に解錠した人は来訪したものとみなされます。たとえばホテルでは、ゲストパスでの遅めのチェックアウトに対応するために、Allow access after end を 15 分に設定できます。
既存のスケジュール
既存の営業時間は、対応する Access Policies の When セクションに自動的にインポートされます。以前に特定のスコープやドアに適用されていた個別の時間は、明示的な Where の対象を持つポリシーとして保持されます。管理者がスケジュールを手動で変換する必要はありません。
認可と利用可能時間
メンバーのアクセスでは、まずユーザーとドアの安全性のチェックが行われます。その後、サーバーはポリシー、恒久的な付与、管理者の時間枠、連携サービスの時間枠の各許可経路を評価します。ジオフェンスとコントローラーのチェックは、引き続きその後の最終的な判定段階です。
将来のポリシーの時間枠では、次の具体的な開始と終了、種類、ラベル、タイムゾーンを含む構造化された利用可能時間が返される場合があります。対応するクライアントはそのデータを表示に使用しますが、認可をローカルで計算することはありません。正確な境界は引き続き [from, to) です。
将来の時間枠による拒否の詳細な理由は outside_access_time_window です。互換性のあるクライアントは、deniedReasonDetail: outside_access_time_window とともに、既存の outside_access_hours の理由を引き続き受け取ることができます。
帰属
ポリシーによる判定では、一致したポリシーが名前で示されます。スケジュールによるアクセスの場合、アクセスログには有効な時間枠とその具体的な開始と終了も表示されるため、どの When のエントリがアクセスを許可したかが明確になります。