リファレンス
このページの内容
ドア/ゲートアクセスの網羅的な表です。すべてのイベントの状態、拒否理由、設定、デフォルト値、上限、オプションの値を 1 か所にまとめています。値の正確な意味を調べるときにこのページを使用してください。各機能の使い方は、リンク先のガイドページで説明しています。
アクセスイベントの状態
アクセスログ に表示されます。
| 状態 | 意味 |
|---|---|
| Request received | 解錠リクエストが届き、評価中です（一時的） |
| Pending | リクエストが確認に合格し、送信を待っています（一時的） |
| Unlocked | 解錠の成功が報告されました |
| Confirmed unlocked | ドアコントローラーがリレーの解放を確認しました |
| Admin Unlocked | 管理者が Performance Hub から解錠しました（管理者による上書き）。指示が送信された時点で記録されます |
| Denied | リクエストが拒否されました。イベントの拒否理由を確認してください |
| Timed out | 指示は送信されましたが、コントローラーが時間内に確認しませんでした |
| Failed | エラーのため解錠を完了できませんでした |
| Locked by staff | 自動解錠スケジュールによってドアが開いている間に、スタッフが 今すぐ施錠 を使用しました（解錠の試行ではなく、スケジュールのイベントです） |
| Schedule resumed | 自動解錠スケジュールが再び適用されました（解錠の試行ではなく、スケジュールのイベントです） |
イベントのライフサイクル：受信 → 送信 → 解錠の確認 / 拒否 / タイムアウト / 失敗。
拒否理由
拒否または失敗した解錠には、それぞれ理由が記録されます。次の表は、理由と、メンバーに表示される内容、対処法の対応を示しています。
| 理由（記録される値） | メンバーに表示されるメッセージ | 原因 | 対処法 |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | ユーザーの Access enabled スイッチがオフになっている | Users のユーザーのパネルで再度有効にする |
no_matching_policy_or_grant | "You don't have access to this door" | Who かつ Where かつ When に一致する Access Policy がなく、アクセスを許可する加算的な付与の経路もない | Access Policies、ユーザーの属性、対象と除外、スケジュール、付与を確認する |
no_matching_policy_target | "You don't have access to this door" | このリクエストについて、このドアを対象とする有効な Access Policy がない | ドアまたはそのドアの Access Scope をポリシーに追加するか、すべてのドアを対象とする設定を使用する |
no_matching_policy_audience | "You don't have access to this door" | ポリシーはドアを対象にしているが、その人の種類、状態、タグに一致するものがない | ポリシーの Who セクションと Users のレコードを確認する |
outside_policy_schedule | "Outside allowed access hours" | Who と Where は一致しているが、一致するポリシーのスケジュールがすべて無効または期限切れになっている | ポリシーの When セクションと施設のタイムゾーンを確認する |
outside_geofence | "Move closer — you're outside the location's geofence." | 報告された位置が、ジオフェンスの中心から 半径 + GPS の精度 + バッファー を超えている | メンバーが近づく。または ジオフェンス の半径とピンを確認する |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | スマートフォンの GPS の精度が Require GPS accuracy better than のしきい値より悪い | メンバーが屋外または干渉のない場所で再試行する。またはしきい値を上げる |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | スマートフォンが使用可能な位置を報告しなかった | メンバーがアプリの位置情報（Precise）を有効にする |
geofence_misconfigured | 解錠が拒否される | ジオフェンスは有効だが、中心（ピン）が設定されていないため、システムが安全側に失敗する | Settings → Geofencing でジオフェンスのピンを配置する |
device_offline | "Door is offline. Please contact the facility." | ドアコントローラーが通信していない（5 分以内のハートビートがない） | コントローラーの電源とネットワークを復旧する。トラブルシューティング を参照 |
user_deleted | "You don't have access…" | Users のレコードが削除された | ユーザーを再作成するか復元する |
outside_access_time_window | ドアが無効になり、わかっている場合は次に利用可能になる時間が表示される | 将来の時間枠がユーザーにとって唯一の許可の経路であり、まだ有効になっていない | 提供されている利用可能時間、タイムゾーン、連携元の鮮度、マッピングを確認する。Access Policies と付与は引き続き独立して適用される |
一部のアプリのバージョンでは、ポリシー固有の拒否に対して、より広い意味の "You don't have access to this door" または "Outside allowed access hours" のメッセージが表示されます。アクセスログには、管理者向けに詳細な理由が保持されます。
アクセス ポリシー
| 項目 | 意味 |
|---|---|
| ポリシーの構成 | 一意の名前、任意の説明、有効フラグ、Who の対象者、Where の対象と除外、When のスケジュール |
| ポリシーの一致 | Who かつ Where かつ When |
| 複数のポリシー | OR。一致する有効なポリシーのいずれかがあれば許可 |
| Who | 人の種類と任意の状態、または同期したタグやカスタムタグ。状態が空の場合はどの状態でも一致 |
| Where | 施設のすべてのドア、Access Scopes、個々のドア、またはその組み合わせ。そのポリシー内では除外が優先 |
| When | Anytime、または OR で結合された Weekly / One-time の時間枠 |
| その他の許可の経路 | 恒久的な付与と、管理者や連携サービスによる時間枠は、別々に加算的に働く |
| 安全 | 削除、無効化、同期によってブロックされたユーザー、ドアの削除とブロック、メンテナンス、ジオフェンス、レート制限、コントローラーの確認は引き続き適用される |
| 既存の設定 | 明示的な Who、Where、When を持つ同等の名前付きポリシーに自動的にインポートされる |
ポリシーの帰属
アクセスログでは、一致したポリシーが名前で識別され、その対象者、対象、スケジュールを表示できます。スケジュールによる一致には、有効な具体的な開始時刻と終了時刻が含まれる場合もあります。
Access Time Window のリファレンス
| 項目 | 意味 |
|---|---|
| 認可 | ポリシーのスケジュールの時間枠はポリシーの When。管理者や連携サービスによる時間枠は、別の加算的な許可の経路 |
| 絶対時刻の境界 | 整数の Unix 秒による UTC の時刻、[from, to) |
| 絶対時刻のタイムゾーン | 表示と監査用のメタデータ。エポックをずらすことはない |
| Weekly の境界 | 終了時刻を含まない、現地時刻の HH:mm のブロック |
| Weekly のタイムゾーン | 曜日、時刻、夏時間を決定する有効な IANA タイムゾーン |
| Weekly の期間 | 任意の Unix 秒による有効開始と有効終了。終了は含まない |
| 日をまたぐ / 重複 | 使用できない。日をまたぐ期間は日ごとに分割し、ブロックが重複しないようにする |
| ユーザーの所有 | 管理者と各連携元は分離されており、一方が他方を消去することはできない |
| 連携サービスのスコープ | 安定した連携元の scope_key（デフォルトは default）を PH の対象にマッピングする。不明またはマッピングされていない場合は安全側に失敗する |
| 連携元の鮮度 | 連携サービスごとの間隔で設定する。連携元が古くなった場合の動作は明示的に定める必要がある |
| 安全 | 無効化、削除、競合のあるユーザー、blockAllAccess、メンテナンス、ジオフェンス、レート制限、コントローラーの確認を回避することはない |
初期の上限：ポリシー、付与、連携元のコンテナあたり 50 の時間枠、絶対期間の最大は 90 日、ID、ラベル、スコープキーは 120 文字、1 日あたり 8 つの週ごとのブロック。新たに書き込むエントリは、すでに 1 時間を超えて期限切れになっていてはなりません。
設定、デフォルト値、範囲
ドアの設定
| 設定 | デフォルト | 範囲 / オプション |
|---|---|---|
| 保持時間 | 10 秒 | 1～30 秒 |
| メンテナンスモード | Normal | Normal / Force open / Force closed |
| ドアの開放音 | オフ | オン / オフ |
| ドアの場所ラベル | — | 自由入力、最大 64 文字 |
| アイコン | Door | 10 種類のオプション（以下を参照） |
| 自動解錠スケジュール | オフ | 施設のスタッフ常駐時間または Custom schedule、施設のタイムゾーン |
| 自動解錠の Unlock / Lock のタイミング | At opening / At closing | At opening / At closing、または 5、10、15、30、45、60、90、120 分前または後 |
| 祝日の自動解錠 | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| アクセスの認可（ドアごと） | Access Policies | 一致するポリシーを一覧表示し、blockAllAccess を設定できる |
| ジオフェンス（ドアごと） | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| オンラインのしきい値 | — | 過去 5 分以内にハートビートがあるコントローラーはオンラインとみなされる |
ドアのアイコン
| アイコン | 用途 |
|---|---|
| Door | 標準の片開きドア（デフォルト） |
| Sliding door | 引き戸、自動ドア |
| Double door | 両開きドア、フレンチドア |
| Garage | ガレージ、シャッター |
| Boom gate | 遮断機、バーアーム |
| Pedestrian | スタッフ用、歩行者用の出入口 |
| Security | 制限区域、セキュリティドア |
| Office | オフィス、スタッフ専用室 |
| Delivery | 荷積み場、搬入口 |
| Locker | ロッカー、倉庫 |
ジオフェンスの設定
| 設定 | デフォルト | 範囲 |
|---|---|---|
| ジオフェンスの有効化 | オン（新しい施設の設定の場合） | オン / オフ |
| 半径 | 200 m | 50～5000 m（10 m 単位。プリセットは 50 / 200 / 500 / 1000 m） |
| 精度のバッファー | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| 許容範囲の計算式 | — | 半径 + 報告された GPS の精度 + 精度のバッファー |
アクセスの猶予期間
Settings → Access Time Windows にあります。
| 設定 | オプション |
|---|---|
| Allow early access | Off / 5 / 10 / 15 / 30 分 |
| Allow access after end | Off / 5 / 10 / 15 / 30 分 |
アプリロックの設定
| 設定 | デフォルト | オプション |
|---|---|---|
| Enforce app lock for this facility | オフ | オン / オフ |
| Grace period before re-prompting | 5 分 | Always prompt / 1 分 / 5 分 / 15 分 / 30 分 / 1 時間 |
| 複数の施設での動作 | — | 紐付けられた施設のいずれかが必須にしている場合に適用。必須にしている施設の中で最も短い猶予期間が優先 |
サポート連絡先
| モード | 動作 |
|---|---|
| Smart (default) | ドアがオフラインの場合や UI の情報が限られている場合に自動的に表示 |
| Always show | アプリのダッシュボードに常に表示 |
| Never show | 表示しない |
アプリのメッセージ
| 項目 | 上限 / オプション |
|---|---|
| 通知タイプ | Information / Notice / Urgent |
| タイトル | 120 文字 |
| 本文 | 2000 文字（500 文字で注意を表示） |
| リンク URL | http(s) のみ、2000 文字 |
| リンクのラベル | 80 文字、デフォルトは "More info" |
| スケジュール | 任意の Starts at / Ends at |
| プレースホルダー（自動ルール） | {firstName}、{lastName} |
| 自動ルールの一致項目 | Membership status / Person type / Tag（タグは同期したタグとカスタムタグに一致、大文字と小文字は区別しない） / Door visibility |
| ルールの優先順位 | 最初に一致した有効なルールが優先（一覧の順序） |
ユーザーの項目
| 項目 | 上限 / 注記 |
|---|---|
| 名 / 姓 | それぞれ 80 文字 |
| 携帯電話番号 / メールアドレス | 少なくとも 1 つが必須（OTP サインインに使用）。電話番号は国際形式に正規化される |
| タグ | タグあたり 80 文字。同期したタグは同期によって上書きされ、カスタムタグは管理者が所有する |
| メモ | 2000 文字 |
| Access enabled | デフォルトはオン。オフにするとすべての解錠が拒否される |
| 付与 | 施設全体、ドアの一覧、スコープの一覧、任意の営業時間 |
| Access Policies | ユーザーは 1 つ以上の名前付きポリシーの対象になる。一覧と実際のアクセス権には Access granted via policy が使用される |
| Access Time Windows | 管理者が所有する編集可能な時間枠と、連携元が所有する読み取り専用の時間枠。ポリシーのスケジュールとは別 |
ソース、状態、その他の列挙値
| 列挙 | 値 |
|---|---|
| ユーザーのソース | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| ユーザーのタイル | All users / Has access / No access / Not synced |
| 招待の状態 | Not invited / Invited / Send failed |
| 招待の受信者 | Only users with door access / All eligible synced users |
| 招待ルールの項目 | Membership status / Person type / Tag / Sync source / Integration。演算子は is any of / is not any of |
| アクセスログのビュー | Door events / No visit recorded |
| アプリの利用状況 | Active（アプリを使用したことがある） / Not yet active |
| 識別子の必須設定（同期） | Email OR phone（デフォルト） / Email required / Phone required / Both required |
| 同期ログの結果 | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| 時間枠の状態 | Active / Upcoming / Expired / Stale / Unmapped |
| 会員状態のラベル | Active、Current、Expired、On hold、Cancelled、Pending（および連携元システムの任意の値） |
| アクセス範囲のテンプレート | Custom、Main entrances、Staff-only、Restricted area、24/7 access、Business hours、Vehicle access、Service entries |
| 自動メッセージのテンプレート | No door access、Expired membership、Payment overdue、Account on hold / suspended、Welcome (new member)、Trial / prospect、Document / waiver required |
同期のスキップ理由
| 同期ログに表示される理由 | 意味 |
|---|---|
| Integration sync is turned off for this facility | 連携元のマスタートグルがオフになっている |
| This integration is turned off in sync settings | 特定の連携サービスが除外されている |
| No phone or email on the record (a phone or email is required to log in) | レコードが識別子の必須ルールを満たしていない |
| Record is decoupled and managed manually | このユーザーの Track source updates がオフになっている |
| No facility on the source record | 連携元のレコードがこの施設に紐付けられていない |
| No matching user record | 変更が、ここに行のない人を参照している |
運用上の上限
| 上限 | 値 |
|---|---|
| CSV インポート | 1 回のインポートにつき 200 ユーザー |
| 一括招待 | 50 件ずつのバッチで送信 |
| 一括削除のプレビューの例 | 最初の 50 ユーザーを表示 |
| アクセスログのクエリ | 期間あたり最新の最大 500 件のイベント |
| アクセスイベントの保存期間 | 約 13 か月、その後自動的に削除 |
| 管理者による解錠の指示の有効期間 | 30 秒（届かなかった場合、指示は期限切れになる） |
| ドアコントローラーのハートビート | 約 30 秒ごと。5 分間通信がないとオフライン |
| サインインコードのリクエスト | 電話番号またはメールアドレスごとに 1 時間あたり 5 回（セキュリティ上の上限で、解除不可） |
| アプリのサインアウトの反映 | すぐに取り消される。有効なセッションが完全に終了するまで最大 15 分 |
| ドアの設定の保存 | コントローラーが再読み込みされる（通常 10～15 秒） |
| No visit recorded の保存期間 | 約 13 か月 |
| Access Time Window のマッピング | 連携サービスあたり 50 |
| コンテナあたりの Access Time Windows | 50 |
| One-time の時間枠の期間 | 90 日 |
| Weekly のブロック | 曜日あたり 8 |
| 時間枠と連携元の ID、ラベル、スコープキー | 120 文字 |
| 施設あたりの Access Policies | 100 |
| ポリシーの時間枠の合計 | 500 |
| Access Policy の名前と ID | 120 文字 |
| Access Policy の説明 | 500 文字 |
| Access Policy の設定 | 300 KiB UTF-8 |