Support Hub/Learn & Insights/ベンダーのSDKはWindowsでしか動かないのか?AI時代になっても?
Translated from the English article and reviewed by a person. Read the English original
Article

ベンダーのSDKはWindowsでしか動かないのか?AI時代になっても?

ベンダーのSDKはWindowsでしか動かないのか?AI時代になっても?

この記事をお読みの時点で、チーム内ではすでに同じ声が上がっているかもしれません。生体認証ハードウェアは問題なく動作しています。デバイスは本来の役割どおりに機能しています。しかし、メーカーが通信用に配布しているSDKは、コンパイル済みのWindows DLLであり、特定のVisual C++ランタイムを必要とし、Dockerコンテナ内では動作せず、開発者はMacまたはLinuxを使用しています。問題はデバイスではなく、SDKにあります。本記事では、なぜそのような状況になるのか、チームが試みた回避策がなぜ最終的にすべて失敗するのか、そして代替となるアーキテクチャがどのようなものかを詳しく説明します。

 

不満はどのエンジニアリングチームでも共通している

具体的な内容は異なりますが、そのパターンは常に同じです。組織が生体認証ハードウェアを導入し、プロジェクトの後半になってSDKの制約に気づき、本来存在すべきでない問題を回避するために多大なエンジニアリング時間を費やします。実際にこうした不満がどのような言葉で語られるかは、次のとおりです。

エンジニアリングチームが毎回口にする言葉
“SDKはWindows版のDLLとしてしか提供されていません。バックエンド全体はLinux上で動いています。生体認証の連携を動かすためだけに、専用のWindows VMを立ち上げなければなりませんでした。”
“コンテナ化できません。Dockerは使えません。Kubernetesも使えません。すべてのデプロイは手作業で、SDKを再インストールして新しいライセンスを取得しない限り、そのマシンを交換することもできません。”
“開発者は全員MacかLinuxを使っています。ローカルで連携を動かせる人がいません。テストには、SDKがインストールされたオフィス内の唯一のWindowsマシンにリモート接続する必要があります。”
“SDKにはVisual C++ Redistributable 2010が必要です。新しい開発者は、連携コードを1行も書く前に、環境構築だけで3日を費やしました。”
“サーバーをWindows Server 2022に更新したところ、SDKが動かなくなりました。ベンダーが更新版をリリースするまで2週間かかり、その間は勤怠データが一切ありませんでした。”
“CI/CDパイプラインでは、生体認証の連携をまったくテストできません。テストはすべて手動です。連携をリリースするたびに、誰かがWindowsマシンの前に座って実行しなければなりません。”

生体認証SDKがWindows専用である本当の理由

生体認証ハードウェアとの通信は非常に複雑なため、Windows固有のシステムAPIが必要なのだろうと考えたくなるかもしれません。しかし、それは事実ではありません。生体認証SDKがWindows専用である本当の理由は、もっと単純で、もっと歯がゆいものです。SDKが最初に開発された環境がWindowsであり、その後その環境を変えるための投資が誰によっても行われなかったというだけのことです。

ほとんどの生体認証デバイス用SDKは、2000年代初頭にCまたはC++で書かれ、当時の主流であった企業向けデスクトップOSのWindowsを対象としていました。コンパイルの成果物はDLL(Dynamic Link Library)で、これはWindows固有のバイナリ形式です。デバイスへのTCP接続を開き、バイナリパケット形式をデコードし、構造化されたデータを返す通信ロジックが、このDLLにコンパイルされて顧客に配布されていました。

当時、これは合理的な判断でした。企業向けソフトウェアはWindowsで動作し、サーバーもWindowsで動き、開発者もWindowsを使っていました。DLL形式は、そのエコシステムにおける再利用可能なコンパイル済みコードの標準的な配布手段でした。その文脈において、この選択が間違っていたことは何もありません。

問題は、状況が完全に変わったにもかかわらず、SDKが変わらなかったことです。Linuxが主流のサーバーOSになり、Macが主流の開発者用ワークステーションになりました。Dockerコンテナが標準的なデプロイ単位となり、クラウドネイティブなインフラがオンプレミスのWindowsサーバーに取って代わりました。しかし生体認証SDKはWindows DLLのままでした。クロスプラットフォームで配布するために書き直すには多大なエンジニアリング投資が必要であり、ハードウェアメーカーにはそれを行う商業的な動機がほとんどないからです。

“このSDKは、LinuxやMacを敵視するように設計されたわけではありません。LinuxやMacが企業向けソフトウェアの動作環境ではなかった時代のために設計されたのです。その時代はもう存在しません。SDKだけが取り残されたのです。”

Windows専用SDKが現代のスタックで妨げること

Windows専用SDKの影響は、現代の開発・デプロイ環境のあらゆる層に波及します。以下の各ブロッカーは、現在の世代のソフトウェアスタックに生体認証ハードウェアを統合しようとする際に、エンジニアリングチームが実際に直面する制約を表しています。

Dockerとコンテナ化
Dockerコンテナは Linux 上で動作します。Windows DLLはLinuxコンテナ内に読み込むことができません。SDKを呼び出す必要のあるサービスは、ベアメタルのWindowsマシンまたはWindowsコンテナ上で動かす必要があります。これは標準的なLinuxコンテナと比べて、重く、移植性が低く、実行コストも高くなります。
Linuxクラウドサーバー
AWS、Google Cloud、Azureはいずれも、標準的で最も安価なサーバーオプションとしてLinux仮想マシンを提供しています。生体認証SDKの連携をホストするためだけにWindows VMを動かすと、コストが増え、生体認証機能そのものとは無関係な運用上の負荷が追加されます。
Macの開発環境
開発者はローカルマシン上でSDKを読み込み、実行し、テストすることができません。連携のテストのたびに、SDKがインストールされた唯一のWindowsマシンへのアクセスが必要になります。生産的なエンジニアリングの基本条件である、ローカルでの開発フィードバックループが、スタックのこの部分では失われてしまいます。
CI/CDパイプライン
自動テストパイプラインはLinuxエージェント上で動作します。ユニットテスト、結合テスト、自動デプロイのチェックには、SDKを呼び出すコードパスを含めることができません。生体認証の連携は、自動化された品質保証のプロセスの外に完全に置かれてしまいます。
サーバーレス関数
AWS Lambda、Google Cloud Functions、Azure Functionsは、マネージドLinuxランタイム上で動作します。Windows DLLを使う限り、生体認証連携のサーバーレスアーキテクチャは不可能です。関数全体を長時間稼働するWindowsプロセスに置き換える必要があり、これはサーバーレスのコストモデルと運用モデルを損なってしまいます。
Kubernetesオーケストレーション
Kubernetesはクラスター全体でコンテナを管理します。Windows SDKに依存するサービスは、Windowsノードプールなしでは標準的なKubernetesオーケストレーションに参加できません。Windowsノードプールは、標準的なLinuxノードプールに比べて設定がはるかに複雑で、実行コストも高くなります。

チームが構築する回避策と、それらがすべて最終的に失敗する理由

Windows専用SDKと現代のスタックに直面したエンジニアリングチームは、回避策を構築します。各回避策は目の前の問題を解決しますが、後で別の問題を引き起こす新たな構造的依存関係を生み出します。

01
専用のWindows VM
SDKを実行するためだけに、Windows仮想マシンがプロビジョニングされます。生体認証の連携サービスはこのVM上で動作し、スタックの他の部分が呼び出す内部APIを公開します。これは恒久的な単一障害点を生み出します。停止しても自動的に置き換えることはできず、水平方向にスケールすることもできず、別個のインフラの責任としてパッチ適用と保守が必要になります。
失敗する場合:VMが廃止、パッチ適用、または移行されてSDKが動かなくなったとき。
02
COMインターロップのラッパー
C#で薄いラッパーを書き、DLLを読み込んでCOMオブジェクトとして、または他のプロセスが呼び出せるローカルのHTTPサービスとして公開します。これにより、言語の境界、プロセスの境界、そして保守が必要な新しいコードベースが追加されます。それを書いた開発者は通常その仕組みを理解している唯一の人物であり、やがて退職してしまいます。
失敗する場合:SDKが更新されてラッパーが壊れたとき、または元の開発者がチームを離れたとき。
03
LinuxでのWine
Wineは、一部のWindowsバイナリをLinux上で実行できるようにする互換レイヤーです。チームによっては、生体認証SDKのDLLをWine上で動かそうとします。これは単純なSDKでは断続的に動作し、Windows固有のシステムコールに依存する複雑なSDKでは予測できない形で失敗します。WineベースのデプロイメントについてSDKベンダーからのサポートは存在しません。
失敗する場合:SDKがWineに実装されていないWindows APIを呼び出したとき。これはよくあることです。
04
Windows Subsystem for Linux
WSL2を使うと、Linuxプロセスを Windows 上で、またその逆で実行できます。チームによっては、SDKをWindowsマシンにインストールし、WSL2のブリッジを通じて公開します。これは開発者の利便性のためのツールを、本番環境の統合手法として転用したものです。本番ワークロード向けには設計されておらず、継続的な負荷がかかると、WSLの境界で不安定さが生じます。
失敗する場合:WSLの更新によってブリッジが壊れたとき、または負荷によって境界層で不安定さが生じたとき。
05
Python ctypesまたはcffi
Pythonのctypesライブラリを使うと、コンパイル済みDLLのC関数をPythonコードから直接呼び出せます。単純なDLLインターフェースであれば、Windows上で動作することもあります。しかし、手動によるメモリ管理、慎重な型マッピング、そしてDLLの呼び出し規約に関する深い知識が必要です。脆弱で、ほとんどの場合文書化されておらず、Windows以外のプラットフォームには完全に移植できません。
失敗する場合:更新でDLLのインターフェースが変わったとき。バージョン管理による保証は一切ないため、変わるでしょう。
すべての回避策に共通するパターン

どの回避策も、Windows DLLを固定された制約として受け入れ、その周囲に構築しています。どれもこの制約を取り除くわけではありません。いずれも複雑さを増し、保守の対象を増やし、新たな障害のパターンを追加します。正しい解決策は、より良い回避策を作ることではありません。DLLへの依存を完全に取り除くことです。

代替アーキテクチャの姿

Windows DLLが存在するのは、デバイスメーカーが、独自のバイナリプロトコルそのものを公開することなく、開発者がデバイスと通信する手段を提供する必要があったからです。DLLは、バイナリの通信形式と開発者のコードとの間にある抽象化レイヤーです。

その抽象化レイヤーは、DLLである必要はありません。JSONを話すHTTPサーバーにすることができます。サーバーは片側でバイナリプロトコルを処理し、もう片側でAPIを公開します。開発者は、あらゆるプラットフォーム、あらゆる言語、あらゆるコンテナ、あらゆるCI/CDパイプライン、そしてOSに関係なくあらゆる開発者のノートPCで動作する標準的なHTTPクライアントライブラリを使って、APIを呼び出します。

SDKアプローチ

特定のマシンにインストールされたWindows DLL。言語固有のFFIまたはラッパーを使って呼び出す。OSとランタイムのバージョンに依存する。コンテナ化できない。CIでテストできない。OSの更新で壊れる。デバイスブランドごとに個別のSDKが必要。

Biometric Gatewayアプローチ

用途の異なる2種類のAPI。Callback APIは、デバイスからのリアルタイムイベントをゼロレイテンシでサーバーにプッシュします。RESTful APIは、サーバーからデバイスへのコマンドを受け付け、実行時間は約15秒です。どちらも、任意でAES-256暗号化を使用するJSON over HTTP/HTTPSを利用します。任意の言語、任意のOSで動作し、完全にコンテナ化でき、任意のCI環境でテストできます。

どちらのAPIタイプも、デバイスの変更を必要としません。デバイスは引き続き独自のバイナリプロトコルで通信します。Biometric Gatewayはデバイスとお使いのアプリケーションの間に位置し、プロトコル変換をすべて内部で処理します。そのプロトコルエンジンは、安全な認証処理、データ取引のログ記録、プロトコル変換、そしてデバイスが一時的に到達できない場合のオフラインキャッシュとキューを管理します。標準化APIレイヤーは、対応するすべてのデバイスブランドにわたって、ID管理、AIおよびMCP連携、コールバックの配信、RESTfulコマンドのルーティング、データの正規化を処理します。

開発チームにとって何が変わるか

SDKがAPIに置き換えられると、開発ワークフローにおける実際の変化は大きなものになります。それらは段階的な改善ではありません。チームが当たり前として受け入れてきた摩擦の種類を、丸ごと取り除くものです。

開発タスク Windows SDKの場合 APIの場合
新しい開発者の環境構築 数時間から数日。Windows VM、SDKのインストール、ライセンス、ランタイムの依存関係 数分。APIのベースURLと認証トークンを環境変数に追加するだけ
ローカルでの開発とテスト SDKがインストールされたWindowsマシンへのリモートアクセスが必要 任意のノートPC、任意のOS、任意のHTTPクライアントツールで動作
CI/CDパイプラインへの統合 標準的なLinuxエージェントでは不可能 標準的なHTTP呼び出し。任意のCI環境で動作
コンテナ化されたデプロイ Windowsコンテナまたは専用VMが必要 任意のLinuxコンテナ、任意のサイズ、完全にオーケストレーション可能
2つ目のデバイスブランドの追加 新しいSDK、新しいDLL、新しいラッパー、新しいドキュメント ブランドに関係なく同じCallback APIとRESTful APIを使用
失敗した操作のデバッグ バイナリプロトコルのログ。多くは文書化されていない 標準的なHTTPレスポンスコードとJSONのエラー本文
OSまたはランタイム更新の影響 SDKの互換性が壊れる可能性があり、ベンダーの更新が必要 クライアントコードへの影響なし

2種類のAPI:開発者が実際に書くもの

対比を具体的にするために、2種類のAPIが実際にどのように動作するかを示します。RESTful APIは、サーバーがデバイスにコマンドを送信するために呼び出します。Callback APIはその逆で、Gatewayがリアルタイムイベントをプッシュするためにサーバーを呼び出します。開発者は、一方の受信側と、もう一方の呼び出し側を書きます。どちらもJSON over HTTP/HTTPSを使用します。DLL、Windowsマシン、SDKのインストールは一切必要ありません。

Callback API、リクエスト、Gatewayからサーバーへ送信
{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}
Callback API、レスポンス、サーバーはこれをGatewayに返す必要があります
{ "status": "done" }

API呼び出しは、任意の言語の任意のHTTPライブラリで行えます。Pythonのrequests、Nodeのfetch、Goのnet/http、シェルスクリプト内のcURLなどです。Macのノートパソコン、LinuxのCIランナー、Kubernetes上のDockerコンテナ、サーバーレス関数のいずれでも、同じように動作します。Callback APIのペイロードは、サーバーが公開しているどのWebhookエンドポイントにも届きます。どのデバイスブランドや入力タイプがイベントを生成したかに関係なく、常に同じJSON形式です。指紋、顔認証、手のひら静脈、RFIDカード、PIN、QRコード、バーコード。サーバーが受け取る構造は常に同じです。DLLは不要。ランタイムへの依存なし。Windowsの要件なし。管理すべきライセンスファイルもありません。

これがお客様のチームにとって意味すること

来週チームに加わる開発者は、リポジトリをクローンし、環境ファイルにGatewayの認証情報を追加するだけで、席に着いてから数分以内に生体認証デバイスへの最初の呼び出しを成功させられます。RESTful APIでは標準的なHTTP POSTを書きます。Callback APIでは標準的なHTTPの受信処理を書きます。Windowsマシン、SDKインストーラー、ベンダーのライセンスキー、バイナリのデバイスプロトコルに関する知識は、いずれも必要ありません。スタック内の他のJSONサービスと連携するのとまったく同じように、Gatewayと連携できます。

よくある質問

SDKをAPIに置き換えると、デバイスの機能が失われますか?
Cams Biometrics Gatewayは、両方のAPIタイプにわたって38の生体認証操作を公開しています。RESTful APIは、ユーザーの追加、レコードの削除、ログの読み込み、生体情報の登録など、サーバーがデバイスに送信するコマンドを処理します。Callback APIは、指紋、顔認証、手のひら静脈、RFIDカード、PIN、QRコード、バーコードの入力による勤怠打刻を含め、デバイスからサーバーへのリアルタイムイベントを配信します。多くの場合、Gatewayはデバイスプロトコルを直接扱うため、特定のメーカーのSDKバージョンよりも多くの機能を公開します。移行前に、Camsサポートチームで、お使いの特定のデバイスモデルとの互換性をご確認ください。
すでにSDKの周りにかなり大きなラッパーを構築しています。そのうちどれだけを捨てる必要がありますか?
ラッパー内のビジネスロジック、どの従業員にどのアクセスレベルを与えるかというルール、HRMSのIDとデバイスのユーザーIDのマッピング、エラー処理とリトライのロジック。これらはすべて再利用可能です。置き換えるのは、DLLの関数を呼び出す層だけです。SDKの関数を呼び出す代わりに、HTTPリクエストを送信します。その層より上のロジックは変わりません。多くの場合、SDKの置き換えは外から見るよりも小さな変更です。
APIは、SDKによる直接接続よりも信頼性が低いのですか?
本質的にはそうではありません。Gatewayはデバイスとの永続的な接続を維持し、デバイスが一時的に到達できない場合に操作をバッファリングするオフラインキャッシュとキューを備えています。接続が途切れている間もイベントが失われることはなく、接続が回復するとCallbackエンドポイントに配信されます。デバイス接続の信頼性を決めるのは、アプリケーションがHTTPで通信するかDLLの呼び出しで通信するかではなく、Gatewayのインフラです。適切に運用されたゲートウェイは、単一のWindows VM上で自己管理しているSDKのインストールを用いて多くのチームが達成している可用性よりも、高い可用性を持つでしょう。
レイテンシはどうですか? 追加のネットワークホップによって、意味のある遅延が生じますか?
ほとんどの生体認証操作では、追加のネットワークホップが加える遅延は1桁のミリ秒です。勤怠のコールバックは、Gatewayがお使いのWebhookエンドポイントにプッシュすることでリアルタイムに配信されるため、遅延の特性は、イベントを受信する直接のSDK接続に近いものです。ユーザーの追加などの書き込み操作では、往復の合計時間は、指示がどのように届いたかに関係なく、デバイス自身の処理時間(1〜3秒)に支配されます。HTTPのホップがボトルネックになることはありません。
特別なクライアントライブラリを使わず、既存のPythonまたはNode.jsのバックエンドからAPIを利用できますか?
はい。APIは、JSON本文を持つ標準的なHTTPを使用します。どの言語のどのHTTPクライアントライブラリも、変更なしで動作します。特別なSDK、Gatewayベンダーが公開しているクライアントライブラリ、言語固有のパッケージは一切必要ありません。JSON本文を持つHTTP POSTリクエストを送信できれば、APIを呼び出せます。アプリケーションの視点から見た統合のインターフェースは、それがすべてです。

結論:SDKの問題には明快な解決策がある

Windows専用の生体認証SDKは、エンジニアリングチームが永遠に回避し続けなければならない事実ではありません。それは、20年前に別のインフラ環境で行われた配布上の決定の結果です。その決定は、バイナリプロトコルの複雑さを吸収し、標準的なAPIを通じてデバイスを公開するゲートウェイによって置き換えることができます。

その移行が行われると、専用のWindows VMは廃止されます。CI/CDパイプラインは生体認証の連携をテストできるようになります。新しい開発者は、数分でローカル環境を設定できます。Dockerコンテナは特別な設定なしで動作します。Macの開発者は、SDKライセンスがインストールされたオフィス内の唯一のマシンにリモート接続する必要がなくなります。これらは小さな生活の質の改善ではありません。何年にもわたってエンジニアリングチームの時間と忍耐を消耗させてきた、構造的な制約の除去です。

Cams Biometrics GatewayはWindows SDKを完全に置き換えます。Cams、ZKTeco、Suprema、Hikvision、Anviz、Morpho/IDEMIA、Virdi、Mantra、Nitgen、Realtime、Biomax、Secugen、eSSL、Matrixなど、多数の生体認証デバイスに、それぞれのネイティブプロトコルを使って接続します。インフラのどこにもSDKのインストールは不要です。2種類のAPIタイプにわたって38の操作を公開しています。デバイスのリアルタイムイベントをゼロレイテンシでサーバーにプッシュするCallback APIと、サーバーからデバイスへのコマンドを受け付けるRESTful APIです。すべての通信は、任意でAES-256暗号化を使用するJSON over HTTP/HTTPSです。ネイティブのMCP統合により、Claude、Gemini、ChatGPTが生体認証操作を直接呼び出せます。オフラインキャッシュとキューが、接続の中断を自動的に処理します。Gatewayは、スタックがLinux、Mac、Windows、Docker、Kubernetes、サーバーレス関数のいずれで動作していても、同じように動作します。DLLなし。Visual C++ Redistributableなし。専用のWindowsマシンなし。ライセンスファイルなし。既存のSDK連携の移行に関する詳細は、CamsBiometrics.comで完全なAPIをご確認ください。

 

Was this article helpful?