本文へスキップ
最終更新 |

仮想デバイスのイベントログを連携する

仮想デバイス機能を使用すると、勤怠管理機能を連携する際にモバイルアプリや他社サービスで発生した出勤・退勤などのイベントを BioStar X に直接記録できます。実際の物理デバイスがなくてもイベントログを体系的に管理できるため、外部システムとの連携に役立ちます。

いつ使用しますか？​

次のような場合に仮想デバイスのイベントログ連携機能を使用してください。

  • 外部勤怠管理システムのイベントを BioStar X で統合管理する必要がある場合

  • モバイルアプリや外部システムで発生した入退記録（Punch Log）を BioStar X に直接保存する必要がある場合（データベース連携なしで出勤／退勤イベントを記録）

  • 他社アプリケーションやサービスから BioStar X API を通じて直接イベントを送信する必要がある場合

開始する前に​

「イベントログ API」ライセンスが有効になっている必要があります。ライセンスポリシーの詳細については、ライセンス ポリシーを参照してください。

情報

ライセンスの適用に関する詳細は、BioStar Xライセンスを参照してください。

仮想デバイスを登録する​

  1. LauncherページでSettingsをクリックします。

  2. 画面左のサイドバーで Device → Device をクリック。

  3. デバイス一覧で画面右上の ボタンをクリックし、Add Virtual Device を選択します。

  4. Add Virtual Device 画面が表示されたら設定情報を入力します。

    • Name：仮想デバイスの名前を入力します。

    • Group：仮想デバイスを割り当てるグループを選択します。

    • Device ID：仮想デバイスの固有 ID を入力します。既存のデバイス ID と重複しない範囲で指定する必要があります。

    • Description：仮想デバイスに関する説明を入力します。

  5. 仮想デバイスを登録するには、画面右下の Apply ボタンをクリックします。

情報

  • Device ID は 100000〜999999 の範囲で指定できます。既存の Suprema デバイス ID と重複しない範囲で指定する必要があります。

  • 既に作成された Device ID の値は変更できません。

デバイスグループを管理する​

仮想デバイスも通常のデバイスと同様にデバイスグループ機能を使用できます。

  • 既存のデバイスと同じグループに配置できます。

  • グループ権限があれば、そのグループ内の仮想デバイスにも権限を付与できます。

情報

デバイスグループの詳細については、デバイスグループを管理するを参照してください。

仮想デバイスの制限事項​

  • 仮想デバイスは次のメニューにのみ表示されます。

    • Settings → Device → Device

    • Monitoring メニューのすべてのイベントログ閲覧およびイベントログプレビュー

    • Data メニューのイベントログ閲覧

  • 仮想デバイスは、ドアおよび Advanced AC で入退室制御機能を使用できません。

  • T&A 用のデバイスとして指定できません。

  • Monitoring メニューのサイドバーにはデバイス一覧として表示されません。

  • デバイス制御機能は使用できません。

  • 「マルチコミュニケーションサーバー」ライセンスのデバイス数には含まれません。

API でイベントログを記録する​

対応イベントタイプ​

次のイベントタイプのみ記録できます。

  • 入退室許可 (Access granted：4088)

  • 入退室拒否 (Access denied：6400)

API パラメーター​

イベントログを記録するときは、次のパラメーターを指定する必要があります。

パラメーター説明必須かどうか
dev_id登録済みの仮想デバイス ID のみ許可必須
evtAccess Granted または Access Denied必須
datetimeイベント発生時刻必須
user_idユーザーID必須
tna_key指定された値のみ入力可能任意
Request example
{
    "packet_device_id" : 100003, // required
    "is_virtual_device" : "true", // required
    "events":[ //4088 access granted, 6400 access denied
        {
            "dev_id": 100003, // required
            "evt": 6400, // required
            "datetime": "2025-08-21T14:12:00Z", // required
            "user_id": "2", // required
            "tna_key": "1"
        },
        {
            "dev_id": 100003,
            "evt": 6400,
            "datetime": "2025-08-21T14:13:01Z",
            "user_id": "2",
            "tna_key": "1"
        }
    ]
}
Response example
{
    "Response": {
        "code": "0",
        "link": "https://support.supremainc.com/en/support/home",
        "message": "Success"
    }
}
情報

  • 単一 API 呼び出しで 1 つの仮想デバイスに対して複数のイベントログを一度に記録できます。

  • API の利用に関する詳細はBioStar X APIを参照してください。

イベントログを照会する​

仮想デバイスで記録したイベントログはメニューで照会できます。

  • Monitoring：すべてのイベントの照会とフィルター、イベントプレビュー

  • Data：すべてのイベントの照会とフィルター

情報

監査トレイル​​

イベントログを記録すると、次の例のように監査トレイルが記録されます。

Access Granted, 2025/08/05 03:37:49, 12階出入口 外部, Administrator(1)
情報

  • イベントを一括して記録しても、イベントごとに個別の監査トレイル項目が生成されます。

  • Audit Trail について詳しくは、監査トレイルを管理する​を参照してください。

トラブルシューティング​

Add Virtual Device ボタンが表示されない場合​

「イベントログ API」ライセンスが有効になっているか確認してください。

API 呼び出しが失敗する場合​

  • 「イベントログ API」ライセンスが有効になっているか確認してください。

  • 登録されているデバイス ID が仮想デバイスであることを確認してください。

  • API パラメーター形式が正しいか確認してください。

イベントが照会されない場合​

  • 記録したデバイスが正しい仮想デバイス ID であることを確認してください。

  • イベントフィルターで該当の仮想デバイスが選択されているか確認してください。

  • イベント記録時にエラーが発生していないか監査トレースを確認してください。

このページは役に立ちましたか？