Support Hub/API & Integrations/公開IPなしで生体認証デバイスに接続する:ハイブリッドコネクターの仕組み
Translated from the English article and reviewed by a person. Read the English original
Developer

公開IPなしで生体認証デバイスに接続する:ハイブリッドコネクターの仕組み

公開IPなしで生体認証デバイスに接続する:ハイブリッドコネクターの仕組み

多くの生体認証連携プロジェクトは、生体認証とは直接関係のない問題で止まってしまいます。それは、クラウドからオフィスのルーターの背後にあるデバイスにどうやって到達するのか、という問題です。公開IPアドレスがない拠点、毎日変わるIPアドレスを持つ拠点、あるいはファイアウォールの受信ポートを開放しないITチームを抱える拠点は少なくなく、その慎重な姿勢は妥当なものです。従来の解決策であるポートフォワーディングは設定が煩雑で、社内ネットワークを外部に晒すことになります。Cams Biometricsは、ハイブリッドコネクターによってこの問題を解決します。これは小さなソフトウェアで、拠点の内側からGatewayへ接続します。本ガイドでは、多くのデバイスに到達しにくい理由、ハイブリッドコネクターの仕組みを平易に説明し、それを通じて何ができるか、そして設定方法を解説します。

01 · ネットワークの課題

多くの生体認証デバイスに到達しにくい理由

ローカルネットワーク上の生体認証デバイスは、私道の先にある家のようなものです。中にいる人はいつでも外に出られますが、誰かがゲートを開けない限り、外からは入れません。クラウドプラットフォームがデバイスに直接到達するには、拠点に公開アドレスがあり、デバイスへ通じるファイアウォールの開口部が意図的に設けられている必要があります。多くの拠点にはそれがなく、それには正当な理由があります。

状況 意味 直接アクセスが失敗する理由
公開IPなし インターネットプロバイダーが1つの公開アドレスを多数の顧客で共有している 拠点へ通じる一意のアドレスが存在しない
IPアドレスが変わる 拠点の公開IPは定期的に変わる 今日有効なアドレスが、明日は別の場所を指す可能性がある
厳格なファイアウォールポリシー ITがインターネットからの受信接続を許可しない クラウドがデバイスとの通信を開始できない
ポートフォワーディング不可 ルーターが大家、ISP、または本社によって管理されている 拠点の誰もゲートを開けない
セキュリティ上の懸念 ポートを開放すると、内部システムがインターネットに晒される 仮に可能であっても、多くの組織はそのリスクを受け入れない

小売店舗、建設現場、倉庫、学校、小規模オフィスはいずれも、これらの制約に直面します。しかし、これらはクラウド生体認証連携を諦める理由にはなりません。接続方法を変えるべき理由なのです。

02 · 直接 vs 間接

ハイブリッドPushデバイスへの2つの接続方法

Camsデバイス、およびdeveloper.camsbiometrics.comで検証済みのデバイスは、Native Pushを介してGatewayに接続し、インターネット経由で直接通信します。その他のデバイスはHybrid Pushで接続します。Hybrid Pushには2つの導入トポロジーがあります。どちらが適しているかは、拠点のネットワーク次第です。

直接トポロジー 間接トポロジー(ハイブリッドコネクター)
接続方法 Gatewayがインターネット经由でデバイスまたはデータベース、ファイルに接続する ローカルコンピューター上のハイブリッドコネクターが、外部のGatewayへ接続する
公開IPの必要性 はい(拠点のコンピューターに必要) いいえ
ポートフォワーディングの必要性 はい いいえ
拠点でのソフトウェア なし ハイブリッドコネクター(ローカルコンピューター上)
最適な用途 公開IPがあり、ITチームがポートフォワーディングに慣れている拠点 ルーターや厳格なファイアウォールの背後にある拠点、または公開IPがない拠点

ほとんどの拠点にとって最も簡単な選択

公開IPとポートフォワーディングを設定できない場合は、ハイブリッドコネクターを使った間接トポロジーを選択してください。顧客側でネットワーク設定が一切不要になるため、通常は最も簡単に導入できる方法です。

03 · 外側から内側ではなく、内側から外側へ

ハイブリッドコネクターの仕組み

ハイブリッドコネクターは、ネットワークの問題を逆転させます。クラウドが拠点に入り込もうとするのではなく、拠点の内側にあるものがクラウドへ手を伸ばします。私道の先にある家の例に戻ると、ゲートを開けてもらうのではなく、住人が外に出て、外の世界から家へ通じる通信回線を開いたままにしておくようなものです。

ハイブリッドコネクターを使わない場合

Cams Gateway

インターネットからデバイスへの到達を試みる

→

拠点のルーターまたはファイアウォール

受信接続をブロックする

→

デバイス

リクエストを受け取ることがない

ハイブリッドコネクターを使う場合

デバイス、データベース、またはファイル

ローカルネットワーク上にとどまる

→

ハイブリッドコネクター

ローカルコンピューター上で動作し、デバイスとローカルで通信する

→

外向き接続

コネクターがGatewayへ接続する

→

Cams Gateway

その接続を通じて、ERP/HRMSとデータをやり取りする

接続は社内ネットワークの内側から開始されるため、そのコンピューター上のWebブラウザーと同じ方法で動作します。拠点に公開IPは不要で、ファイアウォールも新たな受信接続を許可する必要はありません。ハイブリッドコネクターは、片側にあるローカルのデバイス、データベース、またはファイルと、もう片側にある生体認証Gatewayとの間の橋渡し役を果たします。

ポートフォワーディングはネットワークへの扉を開けます。ハイブリッドコネクターは扉を閉じたまま、内側から電話をかけます。

許可すべきポートの確認

外向き接続も、ファイアウォールで許可されている必要があります。多くのネットワークでは一般的な外向きWebトラフィックがすでに許可されていますが、厳格なネットワークでは制限されている場合があります。インストール前に、Cams Web APIドキュメントの「Ports Supported(対応ポート)」セクションを確認し、ITチームと共有してください。

04 · 機能と制限

ハイブリッドコネクターでできること

ハイブリッドコネクターが決めるのは、拠点の接続方法です。できることの内容を決めるわけではありません。それはデバイスとの通信に使われる通信方式によって決まり、3つの中から選択できます。

モード 通信方式 Callback API RESTful API
Indirect Device Device SDK フル対応 フル対応(SDKの制限内)
Indirect DB デバイスソフトウェアのローカルデータベースからのDBプル 勤怠のみ 非対応
Indirect File デバイスソフトウェアの勤怠ファイルのファイル処理 勤怠のみ 非対応
通信方式 動作の仕組み
Device SDK GatewayはメーカーのSDKを通じてハードウェアと通信するため、SDKがサポートするすべての機能がAPI経由で利用できます。フルAPIアクセスに最適な方法です
DB Pull Gatewayは、デバイスソフトウェアが記録を保存するローカルデータベースから新しい勤怠記録を読み取り、お客様のCallback URLへ送信します
File Processing ローカルコンピューター上の指定された勤怠ファイルを継続的に監視します。デバイスソフトウェアがファイルを更新するたびに新しい記録が検出され、リアルタイムでCallback URLへ送信されます

トポロジーと機能は別々の判断です

直接トポロジーと間接トポロジーは、同じ通信方式であれば全く同じ機能を提供します。必要なAPI機能に基づいて通信方式を選び、ネットワークが許可する内容に基づいてトポロジーを選んでください。

Device SDKモードであっても、特定のデバイス機種のファームウェアやSDKによっては、一部の操作が制限される場合があります。必ず実際のハードウェアでテストし、特殊なケースについてはCamsチームに確認してください。

05 · ステップごとの手順

ハイブリッドコネクターの設定

実際の画面はCamsアカウントによって異なりますが、ハイブリッドコネクターの設定はいずれも同じ流れに従います。

1

適切なローカルコンピューターを選ぶ

デバイスと同じローカルネットワーク上のコンピューターを選びます。DB PullまたはFile Processingの場合は、デバイスソフトウェアがデータベースまたは勤怠ファイルを保存しているコンピューターである必要があります。コネクターがそれらへのローカルアクセスを必要とするためです。

2

外向き接続を確認する

Camsのドキュメントにある対応ポートの詳細をITチームと共有し、そのコンピューターが必要な外向き接続を行えることを確認してください。

3

ハイブリッドコネクターをインストールする

そのコンピューターにコネクターをインストールし、アカウントの設定手順に従ってCamsアカウントにリンクしてください。

4

通信方式を選択する

Gatewayがお使いのデバイスのSDKをサポートしている場合は、Device SDKを選択します。それ以外の場合は、勤怠データ用にDB PullまたはFile Processingを選択します。

5

Callback URLを設定する

勤怠イベントの送信先を用意するため、受信側、HRMS、ERP、または自動化ツールのHTTPSアドレスをCallback URLとして設定します。

6

エンドツーエンドでテストする

デバイスで指紋または顔をスキャンし、イベントがCallback URLに届くことを確認します。Device SDKモードでは、テストユーザーの追加など、RESTful操作も試してください。

イベントを送信する受信側が必要ですか? Cams AI Code Generator Promptsを使うと、Python、Node.js、PHPなど複数の言語で完全なコールバック受信側を生成できます。

06 · ベストプラクティス

接続を安定して保つ

インストールが完了すると、ハイブリッドコネクターは拠点のインフラの一部になります。いくつかの簡単な習慣が、その信頼性を保ちます。

実践項目 重要な理由
常時稼働しているコンピューターを使う コンピューターがスリープまたはシャットダウンすると、拠点とGatewayの間の接続が一時停止します
スリープと休止状態を無効にする 省電力設定は、気づかないうちに切断される最も一般的な原因です
コネクターを自動起動する 再起動や停電の後、誰もログインしなくても接続が復旧するはずです
停電から保護する 小型のUPSがあれば、短時間の停電中もコンピューターとネットワークが稼働し続けます
コンピューターを最新かつ安全な状態に保つ ネットワーク上にあるため、他の管理対象マシンと同様に扱ってください
イベントの欠落を監視する 利用の多い拠点が突然イベントを送信しなくなった場合は、まずコンピューターとその接続を確認してください

接続が切れた場合に何が起こるか

勤怠はデバイス上に記録され、Gatewayのオフラインキャッシュとキューは中断に対応できるように設計されています。接続が復旧すると、記録は元のタイムスタンプとともに配信されるため、停止中に行われた打刻も正しい時刻で表示されます。DBプルおよびファイル処理の場合、記録はコネクターが読み取るまでデバイスソフトウェアのデータベースまたはファイルに保持されます。

よくある質問

Camsデバイスにはハイブリッドコネクターが必要ですか?

いいえ。Camsデバイスおよびdeveloper.camsbiometrics.comで検証済みのデバイスは、Native Push経由で接続し、インターネット経由でGatewayと直接通信します。ハイブリッドコネクターはHybrid Pushデバイスに使用されます。

ハイブリッドコネクターはポートフォワーディングより安全ですか?

ローカルネットワークへの受信ポートを開放しないため、一般的なリスク要因を取り除けます。通信はHTTP/HTTPS経由で行われ、認証トークンの検証が行われます。オプションでAES-256暗号化も利用できます。

拠点のIPアドレスが毎日変わりますが、問題になりますか?

間接トポロジーであれば問題ありません。ハイブリッドコネクターは外部のGatewayへ向けて外向きに接続するため、拠点に固定IPや公開IPは必要ありません。

ハイブリッドコネクター経由でも、ユーザーの追加と削除はできますか?

はい。Device SDKモードであれば、デバイスのSDKの制限内で可能です。DBプルおよびファイル処理は勤怠コールバックのみをサポートし、RESTful操作はありません。

ハイブリッドコネクターはHRMSまたはERPと連携できますか?

はい。コネクターは拠点とGatewayの間の接続を担当します。HRMS、ERP、または自動化ツールは、他の接続モードと全く同じように、Callback APIを通じてイベントを受信します。

結論:ネットワークが連携の可否を決めるべきではない

長年にわたり、デバイスの設置場所のネットワークが、どの生体認証連携が可能かを静かに決めてきました。公開IPがなければクラウド接続はできず、厳格なファイアウォールがあればITとの長い交渉が必要になり、IPアドレスが変わると予告なく連携が壊れました。

ハイブリッドコネクターは、その制約を取り除きます。内側から接続することで、一般的な業務用ルーター、厳格なファイアウォール、共有インターネット回線の背後にあるデバイスも、受信ポートを1つも開けることなく、他のデバイスと同じリアルタイム連携に参加できます。

Cams Biometrics Gatewayは、デバイスがどこにあってもオンラインにします。 Native PushはCamsおよび検証済みデバイスを直接接続します。Hybrid Pushは、Device SDK、DB Pull、またはFile Processingを使って他ブランドのデバイスを接続し、公開IPが利用できない場合には、直接トポロジーまたはハイブリッドコネクターのいずれかを使用できます。すべてのイベントは同じCallback APIを通じてシステムに届き、認証トークン検証とオプションのAES-256暗号化が適用されます。プラットフォームの詳細はCamsBiometrics.comでご覧いただけます。接続モードや対応ポートを含む完全なドキュメントはdeveloper.camsbiometrics.comで確認でき、受信側はAI Code Generator Promptsで生成できます。

Was this article helpful?