ビルディングアクセスソリューションおよびAI温度検知ソリューションは、管理者のアクセス管理の負担を軽減し、よりセキュアで快適なアクセスを可能にする日本コンピュータビジョン株式会社（以下、「JCV」）の顔認証ソリューションです。本ソリューションは顔認証サービスを通じて、受付、入退室管理、勤怠管理など、様々の利用シーンにおいてセキュリティ強化と利便性の向上に貢献します。また、豊富な管理者向け機能を持っており、既存のアクセス管理システムと柔軟に連携できます。

SenseLinkはビルディングアクセスソリューションおよびAI温度検知の管理プラットフォームで、SenseLink Cloud、SenseLink GE Enterprise 、SenseLink GE Enterprise Pro の3つのモデルを提供しています。

ここでは、全モデル共通でご利用いただくマニュアルと、各モデルのみでご利用いただくマニュアルを提供しています。 なお、本文中には未リリースなモデルも含まれており、当ドキュメントページの内容を利用いただけない場合がございます。ご了承ください。

マニュアルは改訂される場合があります。詳細は各マニュアルの改訂履歴ページを参照してください。　

本マニュアルでは、言語設定が日本語の前提で用語や図が記載されています。その他の言語を設定してご利用になる場合は、用語や図の内容が異なる場合があります。その際は適宜読み替えてご利用ください。

SenseLinkのモデルによっては、一部項目において内容が異なる場合がございます。

本マニュアルはIT部門に所属するお客様、HTTP/HTTPSベース、JSON形式のWeb APIを利用したアプリケーションの開発・運用経験があるお客様を対象にしています。

​

本マニュアルでは、ビルディングアクセスソリューションおよびAI温度検知ソリューションの管理プラットフォームであるSenseLink と一緒にご利用いただく、V1.1.4以降のSenseLink ToolKit （以下、「ToolKit」）について記載しています。 ToolKitは、SenseLinkへの複数の従業員の一括登録や一括修正、およびSensePass2とSenseThunder、SenseThunder MiniのAPKやファームウェアアップデートを行うことができます。

また、本マニュアルはMac OS環境、言語設定を日本語の前提で用語、図が記載されています。WindowsやLinux、その他の言語を設定してご利用になる場合、は一部用語や図が異なる場合があります。適宜読み替えてご利用ください。

本資料はIT運用担当者向けのものです。Linux、kubernetes、docker、クラウドなどの運用知識が必要です。

1.1 サポート顔認証デバイス

当該製品は、以下の顔認証デバイスとバージョンと接続してご利用いただけます。ここに記載されていない顔認証デバイスはご利用いただけません。デバイスやバージョンによって、一部利用できる機能やSenseLinkと共有するデータが異なります。

この情報は本マニュアル発行時点のものであり、将来的に追加・変更が発生する可能性があります。

SenseLink GE Enterprise Pro V2.3.4

一部のお客様への先行リリース製品です。

• SenseThunder-E

  • SenseThunder-E GE V1.0.3（ClientFRのみ）

  • SenseThunder-E GE V1.1.1

  • SenseThunder-E GE V1.1.3

• SenseThunder-Mini

  • SenseThunder-Mini GE V 1.0.1

  • SenseThunder-Mini GE V 1.0.3

  • SenseThunder-Mini GE V 1.0.7
• SensePass

  • SensePass GE V1.2.3

    一部機能（ビジター管理および認証、拒否リスト管理および認証、ルール管理、勤怠管理、デバイスアラート管理）に対応していません。

  • SensePass GE V1.2.5

2.1 ライセンスアクティベーション

SenseLinkのインストール後、運用担当者はライセンスのアクティベーションを行う必要があります。

バックアップ

リストア

バックアップ

[Create Backup] をクリックします。

バックアップが完了したことを確認します。

リストア

[Restore Data] をクリックします。

1. [Clone instance]

このオプションをクリックすると、新しいインスタンス一式が作成されます。インスタンスの作成が完了したら、サイズを選択します。

新しい内部エントリポイントを取得し、app.yaml でエントリポイントを更新します。

vi /data/senselink/app.yaml

REDIS_HOST: r-e9bta0rqbc2a92o248.redis.japan.rds.aliyuncs.com

udpate_senselink.sh スクリプトを再度実行します。

2. [Continue]

データベースが直ちに復元されますが、Redis インスタンスの場合はダウンタイムが発生します。

ただし、アップデートを再度実行する必要はありません。

バックアップ

[Backup Instance] をクリックします。

リストア

[Restore Database] (以前のバージョンでは [Cloud Database]) をクリックします。

新しいインスタンスが作成されるまで待機します。

新しい内部エントリポイントを取得します。

app.yaml で新規エントリポイントを更新します。

vi /data/senselink/app.yaml

MYSQL_HOST: rm-e9buj601i4mhegppr.mysql.japan.rds.aliyuncs.com

udpate_senselink.sh スクリプトを再度実行します。

1.1 サポートするSenseLinkのモデルおよびバージョン

V1.1.4のToolKit は、以下のSenseLinkに接続してご利用いただけます。

• SenseLink GE Enterprise Pro V2.3.0以上

V1.1.6のToolKit は、以下のSenseLinkに接続してご利用いただけます。

2.1 ToolKitのセットアップ（Windows）

SenseLink Toolkit Setup [バージョン番号]_[YYYYMMDD].exe をご利用中のWindows PCの任意のフォルダに格納してください。 ファイルをダブルクリックすると、ToolKitが起動します。

2.2 ToolKitのセットアップ（Linux）

7.1 登録者グループとは

登録者を勤務地別階層別など任意のグループにまとめて管理することができます。 グループは顔認証デバイスと紐付けことで、ドアやゲート別のアクセス権限をグループ単位で管理できます。

1人の登録者は複数のグループに登録することが可能ですが、異なる登録者タイプのグループには登録できません。本章では従業員を例に、操作手順を記載します。 ビジター、拒否リストの場合は、それぞれのグループ名に読み替えて同様の手順を実施してください。

7.2 グループの新規追加

新しいグループを追加できます。

ナビゲーションメニューの[認証登録者管理]→[従業員グループ管理]をクリックし、従業員グループ一覧を表示してください。登録ボタンをクリックすると、グループ登録画面が表示されます。

グループ名とそのグループがアクセス可能なデバイスを入力し、保存をクリックして登録してください。グループに登録された登録者は、登録されたデバイスのみに顔認証データが連携され顔認証を行うことができます。登録されないデバイスで顔認証を行なった場合、未登録者として認証されます。

グループ名は半角換算で30文字まで登録することができます。文字種の種類はありません。

7.3 グループ情報の修正

既存のグループ情報を修正することができます。

ナビゲーションメニューの[認証登録者管理]→[従業員グループ管理]をクリックし、従業員グループ一覧を表示してください。修正するグループの右側にあるペンアイコンをクリックすると、グループ修正画面が表示されます。

修正内容を入力し、保存をクリックしてください。

7.4 グループ情報の削除

既存のグループを削除することができます。

ナビゲーションメニューの[認証登録者管理]→[従業員グループ管理]をクリックし、従業員グループ一覧を表示してください。削除するグループの右側にある削除のアイコンをクリックしてください。

「グループの登録のみ削除し、登録者情報は削除されません。グループにN 人登録中です。削除しますか？」というメッセージが表示されます。確定ボタンをクリックして、削除を完了させてください。（Nはグループの登録人数によって異なります。）

7.5 グループへの登録

グループに登録者を登録することができます。

ナビゲーションメニューの[認証登録者管理]→[従業員グループ管理]をクリックし、従業員グループ一覧を表示してください。登録したいグループを選択して登録者一覧を表示し、グループへ登録ボタンをクリックしてください。

登録者のグループ登録画面が表示されます。

画面の左側にある選択欄では、登録者の氏名または部署を入力して登録者の検索を行うことができます。検索結果から登録したい登録者のチェックボックスを選択して、登録ボタンをクリックしてください。登録者が画面の右側にある選択済欄に表示されます。 同様の手順で登録したい登録者を選択済にして、確認ボタンをクリックしてください。グループに登録者が登録されます。

7.6 グループからの削除

登録者が登録されているグループから、その登録者を削除することができます。

ナビゲーションメニューの[認証登録者管理]→[従業員グループ管理]をクリックし、従業員グループ一覧を表示してください。削除したいグループを選択し、そのグループの登録者一覧を表示してください。削除したい登録者のチェックボックスを選択し、複数削除ボタンをクリックするとグループから登録者が削除されます。

3.1 ログインページへのアクセス

8.1 ルールとは

登録者グループやデバイスごとに設定可能な認証の期間や時間帯を「ルール」といいます。

例えば、年末年始に特定のグループに特定のドアに設置されるデバイスのみで認証やアクセスを許可したいといった場合など、様々なルールを設定することができます。

8.2 アクセスタイムテーブルの登録

アクセスを許可するタイムテーブルを管理することができます。

ナビゲーションメニューの[ルール管理]→[アクセスタイムテーブル]をクリックし、アクセスタイムテーブルの一覧を表示してください。登録ボタンをクリックし、アクセスタイムテーブル登録画面を表示してください。

タイムテーブル欄にタイムテーブル名を入力してください。入力可能な文字は半角英数字、全半角スペース、漢字、ひらがな、カタカナ、全半角記号です。1～30文字（半角換算）で入力してください。

有効日付欄の開始日と終了日をそれぞれクリックし、このアクセスタイムテーブルを有効にする期間を指定してください。

月曜日〜祝日の各欄では、各曜日および祝日のアクセスを許可する時間帯の設定を行います。

各曜日の右側にあるペン型の編集ボタンをクリックすると、期間登録登録画面が表示されます。 ＋（プラス）ボタンをクリックすると時間帯を設定できます。区切られた複数の時間帯を登録する場合は、＋（プラス）ボタンをさらにクリックし、複数の時間帯を設定してください。 時間帯を削除する場合は−（マイナス）ボタンをクリックしてください。 設定が完了したら、保存をクリックしてください。

アクセスタイムテーブル登録画面に戻ると、期間登録画面で登録した時間帯が青色で表示されます。

タイムテーブルに祝日を登録したい場合、ページ下部にある祝日登録ボタンをクリックしてください。

祝日登録画面が表示されますので、日付と特記事項を入力してください。特記事項は祝日の名前を入力することを推奨します。祝日が毎年変わらない日付の場合、毎年の欄にチェックを入れるとすべての年でその日付を祝日とみなします。春分の日や秋分の日など毎年日付が変わる祝日は、年ごとに日付を登録する必要があります。 内容を入力後、保存ボタンをクリックしてください。 アクセスタイムテーブル登録画面に戻ると、祝日が一覧に追加されています。

タイムテーブルのすべての設定が完了したら、ページ最下部にある保存ボタンをクリックして保存してください。 アクセスタイムテーブルの一覧画面に保存したタイムテーブルが登録されていることを確認してください。大文字と小文字区別はありません。すでに存在しているタイムテーブル名の場合は保存できません。

8.3 アクセスタイムテーブルの修正

登録されたアクセスタイムテーブル修正します。

ナビゲーションメニューの[ルール管理]→[アクセスタイムテーブル]をクリックし、アクセスタイムテーブルの一覧を表示してください。その中、修正したいアクセスタイムテーブルの詳細をクリックしてください。

アクセスタイムテーブル詳細が表示されます。ページ最下部にある更新ボタンをクリックすると、編集モードになります。

編集後保存ボタンをクリックし、修正内容を反映してください。

8.4 アクセスタイムテーブルの削除

登録されたアクセスタイムテーブルを削除します。

ナビゲーションメニューの[ルール管理]→[アクセスタイムテーブル]をクリックし、アクセスタイムテーブルの一覧を表示してください。修正したいアクセスタイムテーブルの削除をクリックしてください。

「この操作は取り消しできません。削除しますか？」というメッセージが表示されます。削除してもよい場合、確定をクリックしてください。アクセスタイムテーブルが削除されます。

8.5 アクセスルールの登録

アクセスルールでは登録されたアクセスタイムテーブルに対し、デバイスや登録者グループを連携します。

ナビゲーションメニューの[ルール管理]→[アクセスルール]をクリックし、アクセスルールの一覧を表示してください。Newをクリックすると、アクセスルール登録画面が表示されます。

アクセスルール登録画面のデバイス欄をクリックし、アクセスルールに連携するデバイスを選択してください。デバイスは複数選択できます。一度選択したデバイスを取り消すには、デバイス名の右にある×をクリックしてください。 デバイスを登録すると、デバイスに登録されたグループの一覧がデバイス-グループ選択欄に表示されます。アクセスタイムルールに連携するグループのチェックボックスを選択してください。 アクセスタイムテーブル欄に、アクセスルールに連携するアクセスタイムテーブルを選択してください。1つのアクセスルールに対して、アクセスタイムテーブルは1件のみ連携可能です。 全ての内容を入力後、保存ボタンをクリックしてください。

アクセスルール一覧画面に戻ります。 アクセスルール一覧画面で、登録したアクセスルールがデバイスごとに表示されていることを確認してください。

8.6 アクセスルールの削除

アクセスルールを削除します。

ナビゲーションメニューの[ルール管理]→[アクセスルール]をクリックし、アクセスルールの一覧を表示してください。削除したいアクセスルールのチェックボックスを選択し、複数削除ボタンをクリックしてください（削除するアクセスルールが1件の場合も、複数削除ボタンをクリックしてください）。 「この操作は取り消しできません。削除しますか？」というメッセージが表示されます。確定ボタンクリックすると、アクセスルールが削除されます。

サービスの停止と削除

全てのサービスを停止してください。

Mercuryサービスを取得します。

既存のサービスを削除します。

kubectl get svc -n component --no-headers=true | awk '{print $1}' | xargs kubectl delete svc -n component

AFDサービスを取得します。

該当するサービスを削除します。

kubectl get svc --no-headers=true | grep alert-feature-db | awk '{print $1}' | xargs kubectl delete svc

mercury-work-01 ansible_host=10.0.100.4の場合、下記のコマンドで削除を実施します。

$ kubectl delete -f /etc/kubernetes/components/minio/default/service.yaml $ kubectl delete -f /etc/kubernetes/components/cassandra/alert/service.yaml $ kubectl delete svc engine-alert-feature-db-proxy $ kubectl delete svc engine-alert-feature-db-worker-1

データ

Cassandra

cassandra pvcを取得します。

３列目の出力を参照してpvを取得します。

kubectl get pv local-pv-a7a94bfe -o=jsonpath='{.spec.nodeAffinity.required.nodeSelectorTerms[0].matchExpressions[0].values[]}' link-pro-23-cv-host-02-10.0.100.8

ホストlink-pro-23-cv-host-02にローカルpvが保存されています。ipアドレスは10.0.100.8

ssh 10.0.100.8

mkdir -p /mnt/backup/cassandra cp -r /mnt/locals/cassandra/alert/volume1 /mnt/backup/cassandra

Minio

MNO PVCとPVを取得します。

ssh 10.0.100.9

mkdir -p /mnt/backup/minio cp -r /mnt/locals/minio/default /mnt/backup/minio

AFD

AFD PVCとPVを取得します。

ssh 10.0.100.8

mkdir -p /mnt/backup/afd cp -r /mnt/locals/afd/volume0 /mnt/backup/afd

新たなサーバでリストア

新たなmercuryの新たなマスターノードで

私たちの場合mercury-work-01 ansible_host=10.0.100.13で下記の操作から実施します。

$ kubectl delete -f /etc/kubernetes/components/minio/default/service.yml $ kubectl delete -f /etc/kubernetes/components/cassandra/alert/service.yml $ kubectl delete svc engine-alert-feature-db-proxy $ kubectl delete svc engine-alert-feature-db-worker-1

Cassandra

新たな volume0-cassandra-alert-0 サーバを取得します。

kubectl get pvc -n componet | minio| awk '{print $3}' local-pv-dfs04x4x kubectl get pv local-pv-dfs04x4x -o=jsonpath='{.spec.nodeAffinity.required.nodeSelectorTerms[0].matchExpressions[0].values[]}' link-pro-23-cv-host-04-10.0.100.13 ssh 10.0.100.13 rm -rf /mnt/locals/cassandra/alert/volume0

RSYNC フォルダー

ssh 10.0.100.8 cd /mnt/backup/cassandra rsync -avzP volume0 [email protected]:/mnt/locals/cassandra/alert/

volume0-cassandra-alert-1/volume0-cassandra-alert-2/volume1-cassandra-alert-0/volume1-cassandra-alert-1/volume1-cassandra-alert-2を繰り返します

Minio

kubectl get pvc -n componet | minio | awk '{print $3}' local-pv-gj04x4xd kubectl get pv local-pv-gj04x4xd -o=jsonpath='{.spec.nodeAffinity.required.nodeSelectorTerms[0].matchExpressions[0].values[]}' link-pro-23-cv-host-04-10.0.100.13 ssh 10.0.100.13 rm -rf /mnt/locals/minio/default

復元

ssh 10.0.100.8 cd /mnt/backup/minio rsync -avzP volume0 [email protected]:/mnt/locals/minio/default

AFD

kubectl get pvc | alert-feature-db | awk '{print $3}' local-pv-cfgx4xd kubectl get pv local-pv-cfgx4xd -o=jsonpath='{.spec.nodeAffinity.required.nodeSelectorTerms[0].matchExpressions[0].values[]}' link-pro-23-cv-host-04-10.0.100.13 ssh 10.0.100.13 rm -rf /mnt/locals/afd/

復元

ssh 10.0.100.8 cd /mnt/backup/afd rsync -avzP volume0 [email protected]:/mnt/locals/afd

サービスを追加します。

$ kubectl apply -f /etc/kubernetes/components/minio/default/service.yml $ kubectl apply -f /etc/kubernetes/components/cassandra/alert/service.yml $ kubectl apply -f /etc/kubernetes/apps/engine-alert-feature-db

podsを復元します。

$kubectl get pods -n component | grep cassandra-alert | awk '{print $1}' | xargs kubectl delete pods -n component $kubectl get pods -n component | grep minio| awk '{print $1}' | xargs kubectl delete pods -n component $kubectl get pods | grep engine-alert-feature-db | awk '{print $1}' xargs kubectl delete pods

(完了)

2.6.1 QRコードコンテンツの生成 (/api/v3/qr/content)

概要

QR コードコンテンツを生成します。

※開発中の機能です。ご利用いただけません。

リクエストアドレスの例

https://HOST:PORT/api/v3/qr/content

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

エラーレスポンスのフィールド

4.1 ダッシュボード概要

ログインすると、以下のようなダッシュボード画面が表示されます。

ダッシュボードは主に以下3つのエリアに分かれます。各エリアについて次節以降で説明します。

4.2 エリアA：ナビゲーションメニュー

エリアAでは、SenseLinkのナビゲーションメニューが表示されます。それぞれのメニューの詳細は、本章以降の各章で説明されます。また一部のメニューは、一部のアカウントからのみ操作/参照できます。各アカウントが持つ権限の詳細については、をご参照ください。

4.3 エリアB：各種ボタン

ハンバーガーボタン:

設定ボタン:

表：ダッシュボードの設定

4.4 エリアC：ダッシュボード

デフォルトダッシュボード

検温（温度検知）ダッシュボード

音声メッセージについて

検温ダッシュボードを表示している際に検温を実施すると、測定結果に応じて以下の音声メッセージが流れます。なお、この音声メッセージを切ることはできないため、不要な場合は表示しているパソコンの音量を下げてください。

1.1 製品概要

本ドキュメントは、主に開発者の方々に利用いただくSenseLink GE Enterprise、SenseLink GE Enterprise Pro、SenseLink CloudのAPIマニュアルです 。

SenseLink GE Open Platformは、SenseLink に基づくオープンサービスプラットフォームです。 サードパーティのシステムはSenseLinkからデバイス、登録者、レコードなどの情報を取得し、SenseLinkが持つ管理機能をすばやく統合できます。

SenseLink GE Enterprise/Enterprise ProにあるOpenAPIはドメイン名またはIPアクセスを制限せず、サーバーにアクセス可能なリクエストの全ては合法であると見なされます。

10.1 勤怠ルールの管理

ナビゲーションメニューの[勤怠管理]→[勤怠ルール]をクリックしてください。勤怠ルールの一覧が表示されます。

初期設定時では「デフォルト勤怠ルール」というルールが登録されています。登録されたすべての従業員はデフォルトで「デフォルト勤怠ルール」が適用されます。「デフォルト勤怠ルール」の設定は修正することができます。

登録ボタンをクリックすると、勤怠ルール登録画面が表示されます。

登録項目とデフォルト勤怠ルールの設定値は以下です。

すべての項目を入力したら保存をクリックしてください。勤怠ルール一覧画面に戻り、登録した勤怠ルールが一覧に表示されます。

10.2 勤務エリアの管理

勤務エリアの管理を行います。勤務エリアはデバイスと連携することができ、従業員が顔認証を行なった際に、そのデバイスに登録された勤務エリアが勤怠レコードに記録されます。勤務エリアが登録されないデバイスで顔認証を行なった場合、デバイスの設定項目の「設置場所」が勤務エリアとして記録されます。

ナビゲーションメニューの[勤怠管理]→[勤務エリア]をクリックしてください。勤怠エリア一覧が表示されます。

登録ボタンをクリックして勤務エリア登録画面を表示します。

勤務エリア欄に勤務エリア名を入力してください。半角英数字、全半角スペース、漢字、ひらがな、カタカナ、全半角記号の1～50文字（半角換算）で登録可能です。

SenseLink Cloudをご利用の場合、Google Mapの検索機能や位置情報を利用することができます。位置情報欄に位置情報の検索ワードを入力し、登録したい住所やビル名、任意の位置情報名を登録してください。 SenseLink GE EnterpriseまたはSenseLink GE Enterprise Proをご利用の場合、位置情報欄に任意の位置情報名を入力してください。

半径（m）はサポートされない機能です。利用できませんので、値を変更しないでください。

登録デバイス欄で連携するデバイスを選択してください。

設定が完了したら保存ボタンをクリックしてください。 勤務エリア一覧に登録した勤務エリアが表示されます。

10.3 勤怠レコードの管理

従業員の勤怠レコードを管理します。出退勤時間や登録された勤怠ルールに基づく勤怠ステータスが管理されます。

ナビゲーションメニューの[勤怠管理]→[勤怠レコード]をクリックしてください。当日の勤怠レコードの一覧が表示されます。

勤怠ステータスは以下の種類があります。

10.4 従業員別 勤怠レコードの管理

従業員別の勤怠レコードを管理します。

ナビゲーションメニューの[勤怠管理]→[従業員別 勤怠レコード]をクリックしてください。デフォルトで、前月から当日までの従業員別の勤怠一覧が表示されます。 日付を変更すると、勤怠一覧の数値を再計算して表示されます。

設定欄の勤怠レコードをクリックすると、勤怠レコードに遷移して選択した従業員の指定期間内の勤怠レコードが表示されます。

10.5 勤怠レコードのエクスポート

勤怠レコードを最大100,000件までExcelファイルにエクスポートすることができます。

ナビゲーションメニューの[勤怠管理]→[勤怠レコード]をクリックしてください。勤怠レコードの一覧が表示されます。上部にあるエクスポートボタンをクリックしてください。

「エクスポートされたExcelファイルのパスワードは現在のアカウントです」というメッセージが表示されます。確定ボタンをクリックすると、勤怠レコードが記載されたExcelファイルがご利用中のPCに保存されます。

ファイル名は　勤怠レコード_[YYYY]-[MM]-[DD]_[YYYY]-[MM]-[DD].xlsx です。[YYYY]-[MM]-[DD]は勤怠レコード一覧検索で設定された開始日時と終了日時が指定されます。

ファイルを開く際にパスワードを求められます。パスワードはファイルエクスポート時にログインしていたのアカウントです。

10.6 従業員別勤怠レコードのエクスポート

従業員別勤怠レコードを最大100,000件までExcelファイルにエクスポートすることができます。

ナビゲーションメニューの[勤怠管理]→[従業員別 勤怠レコード]をクリックしてください。従業員別勤怠レコード一覧が表示されます。 エクスポートボタンをクリックしてください。

「エクスポートされたExcelファイルのパスワードは現在のアカウントです」というメッセージが表示されます。確定ボタンをクリックすると勤怠レコードが記載されたExcelファイルがご利用中のPCに保存されます。

ファイル名は　従業員別勤怠レコード_[YYYY]-[MM]-[DD]_[YYYY]-[MM]-[DD].xlsx です。[YYYY]-[MM]-[DD]は従業員別勤怠レコード一覧検索で設定された開始日時と終了日時が指定されます。

ファイルを開く際にパスワードを求められます。パスワードはファイルエクスポート時にログインしているアカウントです。

2.1.1 バージョン番号の取得 (/api/v3/server/version)

概要

現在のシステムのバージョン番号を取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/server/version

リクエスト方法

アップデート管理では、デバイスのファームウェアとアプリケーションの最新バージョンを確認し、アップデートしたい特定のデバイスを指定して実行することができます。デバイスのアップデートを実施する前に、ファームウェアおよびアプリケーションの新しい機能と改善点について、必ずご確認ください。

12.1 ファームウェア管理

ファームウェア管理では、SenseLinkに連携している顔認証デバイスとそれらのファームウェアの情報を表示できます。

ナビゲーションメニューの[アップデート管理]→[ファームウェア管理]をクリックしてください。デバイスとファームウェアの一覧が表示されます。

「ステータス」フィールドは、デバイスのリアルタイムアップデートステータスを表します。アップデートステータスの詳細は次のとおりです。

12.1.1 ファームウェアのアップデート配信

デバイスをアップデートする際に、さまざまなオプションが用意されています。

「更新可能なファームウェアがあります」または「アップデートが失敗しました」のステータスのデバイスには、一括してアップデートを適用できます。すべてのデバイスをアップデートするには、[適用]ボタンの下と、[デバイス名]ラベルの左側にあるチェックボックスを選択します。アップデート範囲を指定するには、アップデートするデバイスのチェックボックスのみを選択します。

アップデートには、「即時アップデート」、「設定時間アップデート」、「マニュアルアップデート」の3つのモードがあります。

「即時アップデート」

選択したデバイスのステータスがオンラインである限り、適用した直後に新しいファームウェアのダウンロードとインストールを開始します。

「設定時間アップデート」

選択したデバイスは新しいファームウェアのダウンロードを開始し、設定された時間にインストールします。アップデート時間を設定するには歯車アイコンをクリックして、「アップデート時間」の右側にある日付フィールドをクリックすると、 カレンダーが表示されます。アップデート日時はこのカレンダーから選択するか、日付フィールドに入力することで実行日時を指定します。入力のあと、[確定]ボタンをクリックすることで、アップデート日時の設定が完了します。

「マニュアルアップデート」

選択したデバイスは、デバイスから手動でアップデートを確認するまで、新しいファームウェアのダウンロードを開始しません。

アップデート範囲とアップデートモードを選択した後、[適用]ボタンをクリックすると、アップデート確認画面が表示されます。

アップデートするデバイスのシリアルナンバーとタイプを確認し、[配信]ボタンをクリックしてください。アップデートステータスが更新され、デバイスとファームウェア情報のリストでアップデートプロセスを確認できます。

12.1.2 ファームウェアのアップデートをキャンセル

配信されたファームウェアのアップデートはキャンセルすることができます。

デバイスのステータスが「デバイスがオンラインになるまで待機中」、「ダウンロード中」、または「インストール待機中」の場合は、アップデートをキャンセルできます。

アップデートをキャンセルしたいデバイスのチェックボックスを選択し、[アップデートのキャンセルする]ボタンを選択して、[適用]ボタンをクリックします。

アップデートをキャンセルすると、ステータスが「デバイスがオンラインになるまで待機中」のデバイスは、バージョン更新通知を受信しなくなります。「ダウンロード中」または「インストール待機中」のデバイスのアップデートも、「すぐにキャンセルされます。」というメッセージが表示されます。この後、[確定]ボタンをクリックすると、アップデートがキャンセルされます。キャンセル後、デバイスはアップデートを停止し、ダウンロードしたすべての情報が削除されます。

12.1.3 ファームウェアのエクスポート

ファームウェア情報の一覧をExcelファイルへエクスポートすることができます。

ナビゲーションメニューの[アップデート管理]→[ファームウェア管理]をクリックしてください。デバイスとファームウェアの一覧が表示されます。

一覧上部にあるエクスポートをクリックしてください。

「リスト内のすべてのデバイス情報をエクスポートします。 総数は{N}台です。」というメッセージが表示されます。確定ボタンをクリックすると、ファームウェア情報が記載されたExcelファイルが利用中のPCに保存されます。

ファイル名は　ファームウェアのアップグレード_[YYYY]-[MM]-[DD] [HH]_[MM]-[SS].csv です。[YYYY]-[MM]-[DD] [HH]_[MM]-[SS]はエクスポート日時です。

12.2 アプリケーション管理

アプリケーション管理では、SenseLinkに連携している顔認証デバイスとそれらのアプリケーションの情報を表示できます。

ナビゲーションメニューの[アップデート管理]→[アプリケーション管理]をクリックしてください。デバイスとアプリケーションの一覧が表示されます。

「ステータス」フィールドは、デバイスのリアルタイムアップデートステータスを表します。アップデートステータスの詳細は次のとおりです。

12.1.1 アプリケーションのアップデート配信

デバイスをアップデートする際に、さまざまなオプションが用意されています。

「更新可能なアプリケーションがあります」または「アップデートが失敗しました」のステータスとなっているデバイスには、一括してアップデートを適用できます。すべてのデバイスをアップデートするには、[適用]ボタンの下と、[デバイス名]ラベルの左側にあるチェックボックスを選択します。 アップデート範囲を指定するには、アップデートするデバイスのチェックボックスのみを選択します。

アップデートには、「即時アップデート」、「設定時間アップデート」、「マニュアルアップデート」の3つのモードがあります。

「即時アップデート」

選択したデバイスのステータスがオンラインである限り、適用した直後に新しいアプリケーションのダウンロードとインストールを開始します。

「設定時間アップデート」

選択したデバイスは新しいアプリケーションのダウンロードを開始し、設定された時間にインストールします。アップデート時間を設定するには歯車アイコンをクリックして、「アップデート時間」の右側にある日付フィールドをクリックすると、 カレンダーが表示されます。 アップデート日時はこのカレンダーから選択するか、日付フィールドに入力することで実行日時を指定します。入力のあと、[確定]ボタンをクリックすることで、アップデート日時の設定が完了します。

「マニュアルアップデート」

選択したデバイスは、デバイスから手動でアップデートを確認するまで、新しいアプリケーションのダウンロードを開始しません。

アップデート範囲とアップデートモードを選択した後、[適用]ボタンをクリックすると、アップデート確認画面が表示されます。

アップデートするデバイスのシリアルナンバーとタイプを確認し、[配信]ボタンをクリックしてください。アップデートステータスが更新され、デバイスとアプリケーション情報のリストでアップデートプロセスを確認できます。

12.1.2 アプリケーションのアップデートをキャンセル

配信されたアプリケーションのアップデートはキャンセルすることができます。デバイスのステータスが「デバイスがオンラインになるまで待機中」、「ダウンロード中」、または「インストール待機中」のス場合は、アップデートをキャンセルできます。

アップデートをキャンセルしたいデバイスのチェックボックスを選択し、[アップデートのキャンセルする]ボタンを選択して、[適用]ボタンをクリックします。

アップデートをキャンセルすると、ステータスが「デバイスがオンラインになるまで待機中」のデバイスは、バージョン更新通知を受信しなくなります。「ダウンロード中」または「インストール待機中」のデバイスのアップデートも、「すぐにキャンセルされます。」というメッセージが表示されます。この後、[確定]ボタンをクリックすると、アップデートがキャンセルされます。キャンセル後、デバイスはアップデートを停止し、ダウンロードしたすべてのデータが削除されます。

12.1.3 アプリケーションのエクスポート

アプリケーション情報の一覧をExcelファイルへエクスポートすることができます。

ナビゲーションメニューの[アップデート管理]→[アプリケーション管理]をクリックしてください。デバイスとアプリケーションの一覧が表示されます。

一覧上部にあるエクスポートをクリックしてください。

「リスト内のすべてのデバイス情報をエクスポートします。 総数は{N}台です。」というメッセージが表示されます。確定ボタンをクリックすると、アプリケーション情報が記載されたExcelファイルが利用中のPCに保存されます。

ファイル名は　アプリケーションのアップグレード_[YYYY]-[MM]-[DD] [HH]_[MM]-[SS].csv です。[YYYY]-[MM]-[DD] [HH]_[MM]-[SS]はエクスポート日時です。

2.9.1 顔の数の検知 (/api/v1/recognition/check)

概要

認証用顔写真内の顔の数を特定します。

リクエストアドレスの例

https://HOST:PORT/api/v1/recognition/check

リクエスト方法

POST: form-data

リクエストパラメーター

通常のレスポンス

レスポンスのフィールド

エラーレスポンスのフィールド

2.9.2 認証用顔写真品質の検出 (/api/v1/recognition/quality)

概要

認証用顔写真の品質を検出します。

リクエストアドレスの例

https://HOST:PORT/api/v1/recognition/quality

リクエスト方法

POST: form-data

リクエストパラメーター

通常のレスポンス

レスポンスのフィールド

qa_code の説明

エラーレスポンスのフィールド

2.3.1 デバイスアラートの取得 (/api/v2/device/alarm/list)

概要

デバイスアラートのリストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v2/device/alarm/list

リクエスト方法

GET

リクエストパラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

エラーレスポンスのフィールド

2.3.2 デバイスアラートの解除 (/api/v2/device/alarm/disarm)

概要

オンラインデバイスにアラート解除コマンドを送信します。

リクエストアドレスの例

https://HOST:PORT/api/v2/device/alarm/disarm

リクエスト方法

POST: form-data

リクエストパラメーター

通常のレスポンス

エラーレスポンスのフィールド

9.1 認証レコードの管理

デバイスの認証レコードやデバイスのアラートをPushするには、websocket プロトコルを利用します。

注記：本Push通知は、SenseLink GE V1.10.7を利用していたユーザー向けの機能です。 SenseLink GE V2.2.0以降では標準としてイベントサブスクリプションがサポート、利用が推奨されています。

接続アドレス :

ws://HOST:9000/websocket/record/{app_key}/{timestamp}/{sign}

接続パラメーター :