対応機器と接続モード
ゲートウェイが対応する機器、各機器の接続方法（Native Push または Hybrid Push）、各モードで利用できる API 操作について説明します。
はじめに
機器の互換性
Cams Biometric Gateway はすべての生体認証勤怠機器・入退室管理機器に対応しています。お客様が決めるのは、ご利用環境に合う接続モードだけです。
Hybrid Push
その他すべてのブランド
その他の機器は Hybrid Push で利用できます。ご利用環境に合わせて接続モードをお選びください。利用できる API 機能は選択したモードによって異なります。
対応機器ブランド
Cams Biometrics
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime / Startek
Biomax
Secugen
eSSL
Matrix COSEC
+ その他のブランド
対応する認証方式
指紋
顔認証
手のひら静脈
RFID カード
PIN / パスワード
QR / バーコード
GPS 追跡
Cams 生体認証機器：SlimBeast (i34)、Macronium (i35)、Hawking Plus (f38+)、Hawking (f38)、Ultron MultiFaceFP (f34)、Ultron MultiFace (f35)、Galaxy (f36)、Ultron GPS (f37)、CanBio34、GymBio34、RSP10i3、RSP10f1 ほか。
はじめに
接続モードと API の利用可否
すべての生体認証機器は、2 つのプッシュモードのいずれかで Cams Biometric Gateway に接続します。使用するモードは機器の種類によって決まります。
Native Push Cams 機器と検証済み機器
すべての Cams Biometrics 機器と、developer.camsbiometrics.com で検証済みの機器は Native Push で接続します。追加のセットアップは不要で、機器はインターネット経由で Biometric Gateway と直接通信します。
API を完全サポート。コールバック API と RESTful API の両方で、全 38 操作を制限なく利用できます。コールバックは遅延なし、RESTful コマンドは約 15 秒です。
Hybrid Push その他すべての機器
Cams 以外かつ未検証の機器では、ご利用環境に合った Hybrid Push 接続モードを選択します。通信方式と展開トポロジーの組み合わせによって、利用できる API 機能が決まります。
通信方式
(a) 機器 SDKゲートウェイは機器メーカーの SDK を介してハードウェアと通信します。SDK が対応するすべての機能を API から利用できます。API の全機能を使うには最適な方法です。
(b) DB プルゲートウェイは、現場の PC にインストールされたローカルデータベース（機器ソフトウェアが勤怠データを保存する場所）から読み取ります。お客様のサーバーへの勤怠／打刻ログのプッシュのみ対応します。RESTful API は利用できません（ユーザーの追加／削除、ログの取得などは不可）。
(c) ファイル処理指定した勤怠ファイルをローカル PC 上で常時監視します。機器ソフトウェアがファイルを更新するたびに、新しい勤怠レコードが自動的に検出・取得され、リアルタイムでコールバック URL にプッシュされます。API の制限は DB プルと同じで、勤怠のプッシュのみ対応し、RESTful API は利用できません。
展開トポロジー
(X) ダイレクト現場の PC に、ローカルネットワークへのポートフォワーディング付きのパブリック IP があります。Biometric Gateway はインターネット経由で機器／DB／ファイルに直接接続します。
(Y) インダイレクトローカル PC に Hybrid Connector をインストールします。ローカルのマシン／DB／ファイルと Biometric Gateway の間のブリッジとして動作し、お客様側にパブリック IP は不要です。
Hybrid Push — 機能対応表
| モード | 通信方式 | トポロジー | コールバック API | RESTful API |
|---|---|---|---|---|
| ダイレクト機器 | (a) SDK | (X) パブリック IP | すべて対応 | すべて対応（SDK の制限あり） |
| インダイレクト機器 | (a) SDK | (Y) Hybrid Connector | すべて対応 | すべて対応（SDK の制限あり） |
| ダイレクト DB | (b) DB プル | (X) パブリック IP | 勤怠のみ | 非対応 |
| インダイレクト DB | (b) DB プル | (Y) Hybrid Connector | 勤怠のみ | 非対応 |
| ダイレクトファイル | (c) ファイル | (X) パブリック IP | 勤怠のみ | 非対応 |
| インダイレクトファイル | (c) ファイル | (Y) Hybrid Connector | 勤怠のみ | 非対応 |
どのモードを選ぶべきですか？Cams 以外の機器にゲートウェイが対応する SDK がある場合は、機器 SDK モード (a) を選ぶと API の全機能を利用できます。ない場合でも、DB プル (b) またはファイル処理 (c) で勤怠データを取得できます。トポロジーについては、パブリック IP を用意できない場合は Hybrid Connector を使う インダイレクト (Y) が最も簡単に導入できます。
ハードウェアの制限により、API 機能がさらに制限される場合があります。機器 SDK モードであっても、機器モデルのファームウェアや SDK の機能によっては、特定の API が動作しないことがあります。必ずお使いのハードウェアでテストし、Cams サポートチームにご確認ください。