2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

ドクターは一言しか言っていない。私はNFCを読むFileMakerプラグインを作って販売まで始めた

2
Posted at

はじめに

事の始まりは、あるドクターの一言でした。

「この職員カードでFileMakerにログインとかできないの?」

ちょうど職場の勤怠管理システムが刷新され、職員カードがNFCカードに替わってしばらく経った頃です。

私は医療機関の情シスとして、FileMakerの開発・保守・運用をしています。こういった相談は、ときどき舞い込みます。

相談する側としては、ちょっとした相談です。

受け取る側が、ちょっとした相談で終わらせられる人間とは限りません。

調べて、カードを買って、リーダーを並べて、Windowsで試して、最終的にはFileMakerプラグインを作りました。

ドクターは一言しか言っていません。残りは、だいたい私が勝手にやっています。

この記事では、その過程で分かった 「FileMakerでNFCカードのUIDを読み取るには、何が必要なのか」 を、デスクトップ(Windows / macOS)を中心に整理します。

なお、ここで扱うのはUIDの読み取りまでです。最初の相談にある「ログイン」については、カードの識別と本人認証を分けて考える必要があります。 この話には、後ほど戻ります。

カードをかざして、そのカードを識別したい

現場でやりたいことは、例えばこんなことです。

  • 社員証をかざして打刻したい
  • 診察券で患者を呼び出したい
  • 会員カードで来店記録をつけたい

カードの中身を書き換えるわけでも、電子マネーの残高を扱うわけでもありません。カードと登録済みのレコードを紐づけて、該当する人の情報を呼び出したいのです。

今回、そのために使うのがカードの識別子です。FeliCaでは IDm、MIFARE系では UID(Unique Identifier) と呼ばれます。本稿では、説明の便宜上、これらをまとめて「UID」と呼びます。

ただし、読み取れる識別子が常に固定で、一意な値とは限りません。登録キーとして使えるかは、使用するカードで確認する必要があります。

まずは、FileMakerからその値を取れるのか。そこからです。

先に結論

今回採用した構成は、次のとおりです。

FileMaker Pro + 自作プラグイン + USB接続のPC/SC対応リーダー

本稿のデスクトップ検証は、後述するC++で新規実装したプラグイン「fmnfc」で行いました。

押さえておきたいのは、この3点です。

  • FileMaker Go(iOS) の標準NFC機能はNDEFデータを扱うもので、カード本体のUIDを返す機能は用意されていません。
  • FileMaker Pro(Windows / macOS) では、標準の「NFC 読み取りの構成」スクリプトステップがサポートされていません。
  • 今回は、プラグインからOSのPC/SC APIを呼び出す方法でUIDを取得しました。プラグインが唯一の実現方法、という意味ではありません。

以下、順番に見ていきます。


FileMaker Goは「NFCを読める」。ただし、読めるものが違う

まず、誤解されやすいところからです。

FileMaker Goには、iOSのNFC機能を使ってタグを読み取る標準機能があります。「それなら、Goでカードを読めばよいのでは」と考えたくなります。

ただし、タグに書き込まれたデータを読むことと、カード自体のUIDを取得することは別の話です。

Go側の検証環境は、iPhone 13 / FileMaker Go 2025 / FileMaker Server 22.x です。

以下は、手持ちのiPhoneからFileMaker Goで読んだNFCタグの結果です。

{
  "action": "TagRead",
  "error": "",
  "parameter": "{\"source\":\"iOS_NFC_Read\",\"timestamp\":\"11/8/2026 00:39:27\"}",
  "payloadCount": 1,
  "payloads": [
    {
      "identifier": "",
      "primary": "Hello. FileMaker!",
      "secondary": "",
      "type": "U",
      "typeNameFormat": 1
    }
  ]
}

primary に入っている Hello. FileMaker! は、事前にこのタグへ書き込んでおいたNDEFデータです。そして、identifier は空になっています。

私が書いた挨拶を、私のiPhoneが読み返しています。動作確認としては成功ですが、社員証を識別する話は進んでいません。

identifier は、カードのUIDではない

名前を見ると、identifier にカードのUIDが入っていそうに見えます。

しかし、Clarisの公式ヘルプで説明されているこの項目は、NFCレコードの識別子です。カード本体のUIDとは別の情報です。

参考:Claris「NFC 読み取りの構成」

したがって、identifier が空だったことだけを根拠に、「UIDの取得に失敗した」と判断することはできません。

Goから返ってきたのは、タグに保存したNDEFレコードの情報です。NDEF(NFC Data Exchange Format)は、URLやテキストなどのデータをNFCタグに格納するための形式です。

iOSにある機能が、そのままGoから使えるわけではない

AppleのCore NFCには、次のようなセッションがあります。

  • NDEFリーダーセッション(NFCNDEFReaderSession):NDEFメッセージを読み取るためのもの
  • タグリーダーセッション(NFCTagReaderSession):FeliCaやMIFAREなどのタグを扱うためのもの

参考:Apple「Core NFC」

UIDなどの識別情報は、アンチコリジョンなど、カードとの通信を確立する初期段階でやり取りされる情報です。タグに保存されたNDEFメッセージとは、扱うレイヤーが異なります。

iOSアプリを自分で開発する場合には、対応するAPIを使い、必要な許可や設定を用意することになります。XcodeのCapabilities設定などが関係する部分です。

ただし、iOSが持つ機能が、すべてFileMaker Goのスクリプトから使えるわけではありません。また、返ってきたJSONだけから、Goが内部でどのセッションを使っているかを断定することもできません。

今回の用途で重要なのは、FileMaker Goの標準NFC機能には、カード本体のUIDを取得するための項目や機能が用意されていないという点です。

手持ちのカードを一通り試した結果

実際にカードを並べて試すと、UID以前に、読み取り結果が返るかどうかにも違いがありました。

NDEFの書き込みには、自作の簡易iOS TAG Writerを使っています。書き込み側の実装まで説明すると別の記事になるので、ここでは結果に絞ります。

以下は、自分が使ったカード・アプリ・環境での結果です。

カード 種別 読み取り(FileMaker Go) 書き込み(自作アプリ)
NTAG(NDEF書き込み済み) Type A 成功(identifier は空) 成功
NTAG(新品) Type A 無反応 成功
オレンジタグス TS-C1(NDEF書き込み後) FeliCa 成功(identifier は空) 成功
他社製FeliCaカード FeliCa 無反応 無反応
Suica / PASMO FeliCa 無反応 無反応

※「無反応」は、今回のアプリと検証環境で、期待する読み取り・書き込み結果が得られなかったという意味です。

Type A(NTAG)

新品のNTAGカードを袋から出してかざしても、何も返ってきませんでした。しかし、同じカードにNDEFデータを書き込んだ後は読めました。読み取れたのは書き込んだNDEFデータで、identifier は空でした。

FeliCa

今回試したFeliCaカードのうち、自作アプリでNDEFデータを書き込めたのは、オレンジタグス社の TS-C1(管理用シリアル番号入り) でした。このカードに Hello. FeliCa! を書き込んだ後は、FileMaker Goで読み取れました。

{
  "action": "TagRead",
  "error": "",
  "parameter": "{\"source\":\"iOS_NFC_Read\",\"timestamp\":\"11/8/2026 00:42:32\"}",
  "payloadCount": 1,
  "payloads": [
    {
      "identifier": "",
      "primary": "Hello. FeliCa!",
      "secondary": "",
      "type": "U",
      "typeNameFormat": 1
    }
  ]
}

payloads の中身は、primary 以外は先ほどのNTAGの結果と同一です。返ってきたJSONからは、かざしたカードがType AかFeliCaかも判別できません。同じ1枚をデスクトップのFileMaker Pro+fmnfc(プラグイン)で読むとIDmを取得できますが、Goから得られたのは書き込んだNDEFデータです。

参考:検証に使用したTS-C1の商品ページ

一方、今回試した他社製のFeliCaカードでは、自作のiOSアプリでNDEFを書き込めず、FileMaker Goでの読み取りも無反応でした。原因までは、今回の検証では特定していません。手元のSuica / PASMOも、Goでの読み取り結果を得られず、NDEF書き込みにも成功しませんでした。

ただし、この結果を「FeliCaだからGoでは読めない」とまとめるのは不適切です。NDEFを書き込んだTS-C1は読めています。また、Goで無反応だった他社製カードも、デスクトップのFileMaker Pro+fmnfcではUID(IDm)を取得でき、UIDを使った識別には利用できました。

両方に共通する結果

NDEFを書き込んだNTAGとTS-C1の両方で、Goから読み取れたのは書き込んだNDEFデータであり、identifier は空でした。これは前述したNFCレコードの識別子についての観測結果であって、カード自体のUIDではありません。

既存のカードを書き換えず、カード自体のUIDで識別したい。今回の要件には、別の方法が必要でした。


FileMaker Proでは、標準のNFC読み取りを使えない

では、デスクトップならどうでしょうか。

FileMaker Proでは、標準の「NFC 読み取りの構成」スクリプトステップがサポートされていません。WindowsでもmacOSでも、USBリーダーを接続するだけで、このスクリプトステップからカードを読めるようになるわけではありません。

参考:Claris公式ヘルプの互換性表

今回の構成では、FileMakerとOS側のカード読み取り機能をつなぐ部品が必要です。

そこで、外部プラグインを作る方法を選びました。

ここまで来ると、「FileMakerでカードを読む方法を調べている」つもりだった人間が、「FileMakerにカードを読む機能を追加する方法を調べている」人間に変わっています。

本人は、まだ同じ調べ物をしているつもりです。


デスクトップでUIDを取る筋道:PC/SC

USB接続のNFC / ICカードリーダーには、PC/SC(Personal Computer / Smart Card) に対応したものがあります。

Windowsなら WinSCard、macOSなら PCSC.framework、Linuxなら pcsc-lite といった仕組みを通して、カードリーダーと通信します。本稿で扱うデスクトップ環境はWindows / macOSです。

構成を並べると、次のようになります。

FileMaker Pro
    ↕
自作プラグイン
    ↕
OSのPC/SC API
    ↕
PC/SC対応カードリーダー
    ↕
NFCカード

検証に使用したリーダー

デスクトップ環境での検証は、次の組み合わせで行いました。

  • Windows環境:Windows 11 Pro / FileMaker Pro 2025(Ver. 22.x)
  • macOS環境:macOS Tahoe 26 / FileMaker Pro 26

手元では、次のリーダーを使って動作を確認しました。

リーダー 確認した内容・補足
Sony PaSoRi RC-S300 FeliCaに加え、MIFARE Classic / MIFARE UltralightのUID読み取りも確認
ELECOM MR-ICA001 UID読み取りを確認。OS上では Circle CIR315 CL として認識
ABCircle CIR-415A USB・Bluetooth接続でのUID取得を確認
ACS ACR1552U UID読み取りを確認
ACS ACR1555U USB・Bluetooth接続でのUID取得を確認

Bluetooth接続の結果はWindows環境でのものです。接続方法については後述します。

ELECOM MR-ICA001は、表示名からABCircle系のOEMではないかと思われますが、ここは推測です。

以下の写真は、左からELECOM MR-ICA001 / Sony PaSoRi RC-S300 / ABCircle CIR-415A / ACS ACR1552U / ACR1555Uです。

検証に使用したNFCカードリーダー

職員カードを一枚読めればよかったはずなのに、机の上にはリーダーが五台並びました。

PC/SCに対応したほかのリーダーでも同様に扱える可能性はあります。ただし、対応カードやコマンドの実装、ドライバによって結果は変わるため、実機で確認していない機種については断言を避けます。

なお、この一覧は個人で検証した機種を示したもので、後述する製品の動作保証範囲を示すものではありません。

UIDを取得する命令は、5バイト

PC/SCでUIDを取る流れは、おおむね次のとおりです。

  1. 利用するリーダーを選ぶ
  2. カードがかざされるのを待つ
  3. カードとの接続を確立する
  4. UID取得用の擬似APDUを送る
  5. 応答の状態を確認し、データ部分からUIDを取り出す

今回送るのは、この5バイトです。

FF CA 00 00 00

この FF CA 00 00 00(Get Data, P1=0x00)でUIDを取得する形式は、PC/SC Part 3(Rev. 2.01.09, §3.2.2.1.3) に定義されています。

参考:PC/SC仕様の配布ページ

カード向けのAPDUに見えるが、リーダー側が解釈する

この命令は、擬似APDU(pseudo-APDU) と呼ばれるものです。

通常のカード向けAPDUと似た形式ですが、リーダー側の仕組みが解釈し、UID取得処理に対応づけます。

リーダーは、カードがかざされたときのアクティベーション、つまりアンチコリジョンなどの段階で、カードの識別情報を取得します。PC/SC仕様でも、ISO/IEC 14443-3またはISO/IEC 15693のカードのうち、複数カードの同時アクティベーションに対応しないものについては、IFD(リーダー)が認識後にその特性(properties)を記録することになっています(PC/SC Part 3, Rev. 2.01.09, §3.1.3.2.1)。

参考:PC/SC Part 3 Rev. 2.01.09 §3.1.3.2.1

今回の擬似APDUは、FileMakerのプラグインからカードリーダーへ、UIDの取得を要求する命令です。

ただし、リーダーが「アクティベーション時に記録した値」(キャッシュデータのようなもの)を返しているのか、その都度カードへ問い合わせているのかまでは、自分の検証環境では確認できませんでした。

手元の複数のリーダー(Sony / ABCircle / ACS系)で試した限りでは、いずれもカードをかざしている間は同じUIDを安定して返し、カードを外すと応答しなくなりました。

応答を丸ごとUIDにしない

このUID取得コマンドに対する応答には、データ部分のほかに、処理結果を示す末尾2バイトのステータス(SW1 / SW2)が含まれます。PC/SC Part 3で示される出力形式は、Data + SW1 SW2 です。

参考:PC/SC Part 3 Rev. 2.01.09 §3.2.2.1.3、Table 3-8c

例えば正常に読み取れた場合、応答の末尾には成功を示す 90 00 が付きます。

参考:ACR1552U Reference Manual V1.09(公式PDF) 5.3.3.1 Get Data

そのため、返ってきたバイト列を丸ごとUIDとして扱うのではなく、プラグイン側でまず末尾の SW1 / SW2(90 00 など)を確認し、正常に取得できたことを確かめたうえで、ステータスを除いた識別子のデータ部分だけを取り出す必要があります。

今回検証したリーダーでは、この処理によってUID(FeliCaでは8バイト=16桁のIDm)を取得できました。プラグインからこの16進文字列だけを返せば、FileMaker側ではそのままフィールドに保存したり、検索条件に使ったりできます。

PC/SCとの通信を、FileMakerから呼べる形にする

残るのは、このPC/SCとの通信処理をFileMakerから呼べるようにすることです。

プラグインがOSのPC/SC APIを呼び出し、取得したUIDを文字列としてFileMakerへ返します。FileMaker側から見れば、NFC_ReadUID() のようなプラグイン関数を呼ぶ形になります。

ここでの NFC_ReadUID() は、呼び出し方を説明するための例です。実製品の関数名・引数を示すAPI仕様ではありません。

自前実装する場合は、C / C++でFileMaker Plug-in SDKとPC/SC APIをつなぎます。その際は、Windowsの WinSCard とmacOSの PCSC.framework など、OSプラットフォームごとの差異を考慮する必要があります。

リーダーとの接続や応答処理はプラグイン側にまとめる。FileMaker側では、受け取ったUIDでレコードを検索し、その後の業務処理につなげる。そういう役割分担です。


補足:Bluetoothでも読めた。ただし、接続まで同じとは限らない

有線で読めるようになると、次はワイヤレスでも使いたくなります。

配線を一本減らすために、確認事項が増えていきます。

Bluetooth接続のNFCリーダーは、接続するだけでPC/SCとして扱えるとは限りません。鍵になるのは、使用するOS向けに、Bluetooth経由でPC/SCを利用するためのドライバや接続ツールが提供されているかです。

この手の製品には、本体のボタンで USBモード / Bluetoothモード を切り替えられるものもあります。

以下は、自分のWindows環境で、自作のPC/SCプラグインを使って確認した結果です。

Windowsでの接続結果

リーダー USB接続 Bluetooth接続 接続時の補足
ABCircle CIR-415A UID取得成功 UID取得成功 Windowsの標準的な手順で接続できた
ACS ACR1555U UID取得成功 UID取得成功 メーカー提供の接続ツールを使用した

ABCircle CIR-415A は、USB接続に加え、Bluetooth接続でもPC/SC経由でUIDを取得できました。BluetoothでもWindowsの標準的な手順で接続でき、素直に動きました。

一方、ACR1555U は、私の環境では Windows標準のBluetooth設定からの接続に失敗しました。

メーカーのBLEドライバをインストールすると、接続ツールもデスクトップに配置されます。そのツールを使って接続を確立した後は、PC/SC経由でUIDを取得できました。

両機種ともUSB・Bluetoothの両方でUIDを取得できましたが、そこへ至る手順には違いがありました。

macOSでは、今回の検証はUSB接続まで

検証時に確認できたBluetooth用ドライバは、どちらもWindows向けでした。そのため、今回の構成ではmacOSからBluetooth経由でPC/SCを利用できず、USB有線接続で使う形になりました。

これは、今回使用した機種・ドライバ・環境での結果です。macOSやBluetoothリーダー全般について、利用できないと結論づけるものではありません。

応答速度にも差があった

手元で、カードをかざした状態で関数を呼んでからUIDが返るまでの時間を計測した限りでは、次の程度でした。

接続方式 UID取得時間の目安
USB 数ミリ秒程度
Bluetooth 数十ミリ秒から、ときには数百ミリ秒

1回かざして終わる打刻のような用途なら、体感差はほとんどありません。ただし、連続して速く読みたい用途では、有線のほうが有利です。

これらは手元での参考値です。環境やファームウェア、ドライバのバージョンによって、挙動や時間は変わる可能性があります。

今回の検証では、まずUSB接続で動作を確認するのが進めやすいと感じました。ワイヤレスが要件なら、購入前に対応OSとドライバ、接続方法まで確認しておく必要があります。

なお、このBluetoothの節は個人での検証結果であり、後述するプラグインの動作保証範囲ではありません。


UIDは「鍵」ではなく「名札」

ここで、最初の相談に戻ります。

「この職員カードでFileMakerにログインとかできないの?」

UIDは読めるようになりました。ただし、これだけで、安全なログインまで完成したわけではありません。

カードを識別することと、本人を認証することは別です。

UIDを登録済みのレコードと照合すれば、その値に紐づけた職員や患者、会員のレコードを呼び出せます。しかし、カードをかざしている人が本人であることまでは保証できません。カードの貸し借りだけでも、そこに違いが生じます。

そもそも、取得できる識別子が固定値とは限りません。

Apple Watchから返ってきたのは、毎回変わる値だった

手持ちのApple Watchを待機中のリーダーに近づけ、Apple Payが起動した状態でサイドボタンをダブルクリックすると、リーダーは識別子を返しました。

値は 08 から始まる8桁の16進文字列、つまり4バイトです。残りの6桁は、かざすたびにランダムに変わりました。

NXPの資料では、ISO/IEC 14443-3で規定された Random ID(RID) について、先頭が 0x08 の4バイト識別子という形式が説明されています。これは、動的に生成される値です。

参考:NXP AN10927「MIFARE product and handling of UIDs」 2.1.1 Random ID (RID)

カード以外の機器からも識別子が返り、その値が固定とも限りません。このように値が変わる識別子は、そのまま固定の登録キーには使えません。

UIDが返ってきたことだけで、登録済みのカードそのものだとか、かざした人が本人だとかは判断できません。

便利な識別と、認証の根拠を分ける

UIDを使って操作を簡単にできる場面はあります。

  • 職員・患者・会員のレコードを呼び出す
  • 来店・来場記録をつける
  • 出退勤の打刻操作を補助する

ただし、打刻でも不正防止が必要なら、その要件に応じた確認の仕組みが必要です。入退室、決済、重要な情報へのアクセスなどでも、UIDだけを本人認証の根拠にするべきではありません。

UIDは、登録情報を探すための「名札」と考えると扱いやすいと思います。名札が読めたことと、本人確認が済んだことは違います。

今回実装したUIDの読み取りは、最初の相談を実現するための一つの部品です。FileMakerへのログインをどう成立させるかは、アクセス権限も含めた認証設計の話になります。


まとめ

今回の検証と実装で整理できたのは、次の点です。

  • FileMaker Go の標準NFC機能から得られるのはNDEFレコードの情報で、返ってきたJSONの identifier はカード本体のUIDではない
  • FileMaker Pro では標準のNFC読み取りスクリプトステップを利用できないため、今回は PC/SC対応リーダー+自作プラグイン を使った
  • PC/SCでは、擬似APDU FF CA 00 00 00 を使ってUIDを取得し、応答の状態とデータ部分を分けて扱う
  • BluetoothでもUIDを取得できたが、OS・ドライバ・接続手順に条件があった
  • UIDは識別のための「名札」であって、本人認証のための「鍵」ではない

カードをかざし、UIDを読み取り、FileMakerのレコードを呼び出す。

今回作ったのは、そのためにFileMakerとOSの間をつなぐ部品です。どこまでをFileMakerで扱い、どこからを外側に任せるかが整理できると、必要な構成が見えてきました。

プロトタイプはCで稼働中。「fmnfc」はC++で新規実装

最初に開発したのは、Windows専用にCで実装したNFCプラグインのプロトタイプです。現在も勤務先で稼働しています。

その後、個人で 「fmnfc」をC++ベースで新規実装しました。勤務先の承認を得たうえで、ライセンス販売を始めました。

fmnfcは、USB接続のカードリーダーで社員証などのNFCカードのUIDを読み取り、FileMakerへ返すプラグインです。Windows / Apple Silicon Mac に対応しています。

導入を検討される事業者向けには、評価版も提供しています。対応リーダーや利用条件、サンプルファイルなどの詳細は、fmnfcの製品サイトをご覧ください。

同じように「手元の社員証や診察券を、FileMakerの業務で使いたい」と考えている方の参考になれば幸いです。

きっかけをくれたドクターと、相談に乗ってくださった方々、この取り組みを支えてくださった皆さんに感謝します。

おわりに

「標準機能ではできません」は、調査結果です。そこで終わりにするかどうかは、また別の話です。

今回も、ドクターのちょっとした相談から始まりました。

調べて、試して、足りない部分を作っているうちに、FileMakerの外側まで来ていました。

最初は職場での試作だったものが、気づけば個人開発にまで話が広がり、C++で新たに実装して、勤務先の承認を得て、ライセンス販売まで始めました。

製品サイトも作り、今こうして記事まで書いています。

我ながら、返事が長いです。

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?