事例紹介:Server Approval による1人用入室制御
要件
立ち入りを制限した部屋(サーバールーム、金庫室、ラボなど)を運用するお客様から、ドアで次のようなシンプルかつ厳格なルールを適用したいというご要望がありました。
部屋の中にいられるのは同時に1人だけです。現在の入室者がチェックアウトするまで、次の人を入室させてはいけません。
Cams デバイスは本人確認を担当し、Server Approval はそこにお客様独自のソフトウェアによる「すでに誰かが中にいるか?」という判定ロジックを追加して、本人確認済みのユーザーを実際に入室させてよいかどうかをリアルタイムで判断できるようにします。
Server Approval が適している理由
デフォルト(Server Approval が無効)の場合、デバイスはローカルでユーザーを確認するとすぐにアクセスを許可し、お客様のソフトウェアが知るのはその後です。単純なログ記録には問題ありませんが、入室を阻止することはできません。
Server Approval を有効にすると、デバイスはローカル確認の後で一時停止し、ドアを開ける前にお客様のソフトウェアがパンチを承認するのを待ちます。この往復通信があるからこそ、「すでに誰かが中にいるか?」といった業務ロジックを、事後に記録するだけでなく、アクセス判定そのものに組み込むことができます。
処理の流れ
- ユーザーがデバイスでパンチします。
- デバイスがローカルで本人確認を行い、登録されたコールバック URL に JSON リクエストを送信します。
- お客様のソフトウェアが自身の在室状態を確認し、次のように応答します。
{"status": "done"}→ デバイスはパンチを受け付け、ドアを開けます。{"status": "reject"}→ デバイスはアクセスを拒否し、ドアを閉じたままにします。
- チェックアウト時に、お客様のソフトウェアが在室状態を更新し、次のチェックインが正しく判定されるようにします。
2人のユーザーで見る流れ
ユーザー X がチェックインします。デバイスが X を確認してコールバックを送り、お客様のソフトウェアは部屋が空であることを確認して done を返します。X が入室します。ソフトウェアは部屋を「使用中」にします。
X が中にいる間に、ユーザー Y がチェックインしようとします。デバイスは Y を確認し、他のパンチと同様にコールバックを送ります。ソフトウェアは部屋がまだ使用中であることを確認し、reject を返します。デバイスは Y のアクセスを拒否し、ドアは閉じたままです。ソフトウェアが別の判断を返さない限り、Y が入室することはありません。
X がチェックアウトします。ソフトウェアはチェックアウトを記録し、在室フラグを解除します。
Y が再度試みます。コールバックの流れは同じですが、今回はソフトウェアが部屋が空いていることを確認して done を返します。Y が入室します。
デバイスの役割は常に変わりません。人物を確認し、次に何をすべきかをお客様のソフトウェアに問い合わせるだけです。「reject」と「done」を分けるのは、現在誰が中にいるかについてソフトウェアが把握している内容だけです。
実装上の注意点
- 在室チェックはすべてお客様側の責任です。デバイスは誰が中にいるかを記憶していません。1人専用のスペースであれば、部屋ごとのシンプルなフラグまたはレコードで十分です。複数の部屋や複数人収容の構成では、部屋/デバイスをキーとする小さな状態テーブルが必要になります。
- チェックアウトのイベントを確実に取得できるようにしてください。チェックアウトを取りこぼすと、ユーザーが退室した後でも部屋が永久にロックされたままになります。
- 本番稼働の前に、コールバック経路をローカルでテストしてください。開発環境に対して ngrok/Cloudflare Tunnel/localhost.run を設定する方法については、関連ガイドのトンネリングツールを使った Cams API コールバックのローカルテストをご覧ください。
考慮しておくべき点:接続状況とコールバックの応答
Server Approval は、デバイスとサーバー間のリアルタイムの往復通信、そしてサーバーが常に正しく応答することに依存します。次の2つの状況を想定して設計することをお勧めします。
デバイスがオフラインの場合。デバイスは検証コールバックをリアルタイムで送信できないため、お客様のソフトウェアが done または reject を返す機会がありません。デバイスには「Disconnected」というメッセージが表示され、パンチは完全に拒否されます。ローカルのみのアクセスに切り替わることはありません。
コールバックが {"status": "done"} でも {"status": "reject"} でもない値を返した場合。無効または想定外の応答はキューに滞留し、問題が解消されるまでデバイスは以降のパンチデータをコールバックに送信しません。そのため、そのユーザーだけでなく、以降のすべてのユーザーに対しても、コールバックが再び正しく応答するまでドアは閉じたままになります。
言い換えると、「同時に1人だけ」という保証の強さは、デバイスのネットワーク接続とコールバック応答の信頼性次第です。本番環境では、この両方を設計に織り込んでください。たとえば、Wi-Fi ではなく有線接続を使う、長時間のオフラインをアラートで検知する、エラー時の処理経路でも常に正しい形式の done/reject 応答を返すよう厳密に検証する、といった対策が考えられます。
結果
Server Approval を有効にし、お客様のソフトウェアに最小限の在室フラグを実装することで、「同時に1人だけ」という要件を、既存のデバイス機能のみで実現できました。追加のハードウェアは不要で、デバイス側で必要だったのは設定の切り替えだけです。