ユーザー

Users タブには、この施設でモバイルアプリを使用してドアを解錠できる（または解錠できる可能性がある）すべての人が一覧表示されます。このページでは、ユーザーの追加、CSV のインポートとエクスポート、Access Policy による許可の表示、恒久的な付与、管理者/連携サービスの個別の Access Time Windows、アクセスのキルスイッチ、アプリのアクティビティ、セッション、削除について説明します。

図 1：Users タブ

ユーザーの取り込み元

各行には、その行の作成方法を示す ソース があります。

Performance Hub のスタッフの同期はデフォルトでオンです。連携サービスと Computer Vision の同期はデフォルトでオフです。これらは Settings → Sync settings で設定します。同期と連携 を参照してください。

各行には 携帯電話番号またはメールアドレスの少なくとも一方 が必要です。これは、ワンタイムコードでモバイルアプリにサインインする際に使用されます。

統計とフィルター

図 2：統計タイル

タイルをクリックすると一覧が絞り込まれます。（タイルを選択すると、Source フィルターもリセットされます。）

図 3：検索、Export CSV、Import、Add user、フィルターチップ、並べ替え

• Search：名前、電話番号、メールで検索します。
• CSVをエクスポート：現在の絞り込み結果の一覧をダウンロードします。たとえばジムでは、復帰キャンペーンの前に No access のユーザーをエクスポートできます。
• Import と Add user：以下を参照してください。
• フィルターチップ：

• Sort by：Name、Recently added、Recently updated、Last used、Last synced。昇順/降順の切り替えがあります。
• 検索やフィルターが有効なときは、Clear filters が表示されます。

ユーザー行の見方

図 4：バッジが表示されたユーザー行

同期された行には、名前の下に External ID または Computer Vision ID も表示されます。スタッフの行には、代わりに Performance Hub のロールが表示されます。

大きな一覧は段階的に読み込まれます。残りの一覧を読み込んでいる間、一覧の下部に N more users loading… と表示されます。

ユーザーを手動で追加する

1. Add user をクリックします。

図 5：Add user ダイアログ

2. First name、Last name、および Mobile phone または Email の少なくとも一方を入力します。"At least one of mobile phone or email is required for OTP login."（OTP ログインには、携帯電話番号またはメールの少なくとも一方が必要です。）電話番号は国際形式に正規化されます。
3. 必要に応じて、Person type（例：Gold、Trial、Staff）、Custom tags（カンマ区切り。既存のタグはフィールドの下に一覧表示されます）、Notes を設定します。
4. すぐにアプリのダウンロードリンクをメールで送信するには、Send email invitation にチェックを入れます（メールアドレスが必要です。メールアドレスがない場合、チェックボックスは無効になります）。
5. Add user をクリックします。

同じ電話番号/メールを持つユーザーがこの施設にすでに存在する場合は、ダイアログにその旨が表示され、重複を作成する代わりに Open existing user を選択できます。

ユーザーを追加しただけでは、そのユーザーはどのドアも通過できません。一致する Access Policy、恒久的な付与、または管理者/連携サービスの個別の Access Time Window が引き続き必要です。

CSV からユーザーをインポートする

Import をクリックすると、スプレッドシートからユーザーを一括作成できます。上限は 1 回のインポートにつき 200 ユーザー です。

図 6：CSV インポートウィザード

手順 1：CSV をアップロードします。 .csv ファイルをドラッグするか、クリックして参照します。Download template を使用すると、正しいヘッダー付きのひな形ファイルを入手できます。

手順 2：フィールドをマッピングします。 CSV の各列を、First name、Last name、Mobile phone、Email、Person type、Tags、Notes、Access enabled、Door grants、Scope grants のいずれかのフィールド、または Do not import にマッピングします。一般的なヘッダー名（例：mobile、phone、groups）は自動的にマッピングされます。携帯電話番号またはメールの列を少なくとも 1 つマッピングする必要があります。

• Access enabled には true/yes/enabled/1/on/y/active と false/no/disabled/0/off/n/inactive を使用できます。
• Door grants / Scope grants には、ドアまたは Access Scope の 名前 を指定します。一致しない名前はプレビューで警告が表示されます。

手順 3：プレビューしてインポートします。 最初の数行を確認し、Send invitation email to imported users を選択するかどうかを決めて（招待されるのはメールアドレスのあるユーザーのみです）、Import をクリックします。結果には Imported、Skipped (already exist)、Errors の件数が表示されます。

ユーザーの詳細パネル

任意の行をクリックすると、ユーザーのパネルが開きます。

図 7：同期されたメンバーのパネル

プロフィールと ID

ヘッダーには、ソース、会員ステータス、External ID、ユーザーがポリシーによって許可されているかどうかが表示されます。

• First name / Last name / Mobile phone / Email：同期されたユーザーの場合、行が切り離されていない限り（以下を参照）、同期のたびに上書きされます。
• Person type と Membership status：Access Policy の Who の条件で使用されます。
• Synced tags（読み取り専用。ソースシステムから取得）と Custom tags（管理者が所有。同期で上書きされることはありません）。どちらもポリシーのタグの条件を満たすことができます。
• Notes：自由記述のテキストで、最大 2000 文字です。

アプリのメッセージ

App messaging では、このユーザーのアプリのダッシュボードに表示される個人向けメッセージを設定します。施設全体のバナーも有効な場合は、その上に重ねて表示されます。自動メッセージが適用される場合は、パネルにそのメッセージが表示され、このユーザーの自動メッセージをオフにするための操作が表示されます。アプリのメッセージ を参照してください。

Track source updates（同期されたユーザーのみ）

Integration/CCTV のユーザーの場合、Track source updates トグルで、同期が行を上書きし続けるかどうかを制御します。

• オン（デフォルト）： 同期が成功すると、名前、電話番号、メール、種類、ステータス、同期タグ、ソースが所有する Access Time Windows が更新されます。
• オフ（切り離し）： 明示的な確認の後、ソースが所有する Access Time Windows がクリアされ、同期はこの行を完全にスキップします。手動での編集内容と管理者が所有するウィンドウは保持され、ソースでの削除も影響しなくなります。行には Decoupled バッジが表示されます。

再び連携するには、トグルをオンに戻します。現在のソースのウィンドウのスナップショットは、次に完全な同期が成功したときに復元されます。取得に失敗した場合や部分的な取得からは復元されません。

同期されたユーザーのパネルには、ソースのレコード（Integration のレコードまたは Computer Vision の人物）へのリンクも表示されます。

連携によって削除済み

連携サービスでメンバーが削除されると、そのメンバーのドアのアクセス権が削除され、パネルに Removed by integration と表示されます。行は一覧に残るため、履歴は保持されます。同期と連携 を参照してください。

アクセス制御

図 8：Access Control セクション

Access Control セクションには、ユーザーの認可に関する設定（アクセスのキルスイッチ、ポリシーの適用範囲、追加の恒久的なアクセス、管理者/連携サービスの Access Time Windows）がまとめられています。

Access enabled（キルスイッチ）

Access enabled トグルを使用すると、このユーザーのすべてのドアへのアクセスを即座にブロックまたは復元できます。オフの場合：

• ポリシー、付与、Access Time Windows に関係なく、メンバーによるすべての解錠の試行が拒否されます（理由：access disabled）。
• 行に Disabled バッジが表示され、一覧では淡色で表示されます。

レコードを削除したりポリシーを変更したりせずに、すぐに利用を停止したい場合に使用します。

追加の恒久的なアクセス

付与を使用すると、施設の Access Policies で許可されている内容 に加えて、特定の人にアクセス権を与えることができます。ポリシーがすでにユーザーを対象としている場合、セクションには Allowed by policy と "This user's door access is set by policy — no manual grants are needed."（このユーザーのドアのアクセス権はポリシーで設定されています。手動での付与は不要です。）と表示されます。Show をクリックすると、付与のエディターが開きます。

ポリシーですでに対象となっているドアには Already covered by policy または Set by policy と表示されるため、手動の付与が不要な箇所がわかります。付与には独自の利用時間を設定でき、付与が適用される 時間帯 を制限できます。Clear all を使用すると、すべての付与を一度に削除できます。ポリシーの自動インポートやその後のポリシーの編集によって、恒久的な付与が変更されることはありません。

ポリシーと付与の表示は追加的です。不要な手動の付与を削除してもポリシーによるアクセス権は削除されず、ポリシーを編集しても付与は削除されません。

アクセス時間ウィンドウ

Access Time Windows セクションでは、この人の一時的な追加アクセスを管理します。Add one-time window と Add weekly window で追加できます（最大 50 件）。

• 管理者が所有する絶対時間および毎週のウィンドウは編集可能で、施設、選択したドア、または Access Scopes を対象にできます。
• 連携サービスが所有するウィンドウは読み取り専用で、ソース、ソース ID、宣言されたタイムゾーン、論理スコープのマッピング、ソースの経過時間、鮮度の状態が表示されます。
• 有効、予定、期限切れ、期限超過（stale）、マッピングなし（unmapped）の状態は個別に表示されます。期限超過またはマッピングなしのウィンドウはアクセスを許可しませんが、Access Policies と恒久的な付与は代替パスとして引き続き利用できます。
• 正確な時刻には [from, to) の境界が使用されます。毎週のウィンドウでは、表示されている IANA タイムゾーンとその夏時間のルールが使用されます。

パネルには "Time windows add access. They do not restrict existing rules or grants."（タイムウィンドウはアクセス権を追加するものです。既存のルールや付与を制限するものではありません。）と記載されています。Access Policy のスケジュール を参照してください。

招待

アプリの招待メールが送信されたかどうか、送信日時、失敗したかどうかが表示されます。ボタンには Send invitation email または Resend invitation email と表示されます。招待はメールのみで送信されます。詳細は アプリへの招待 を参照してください。

セッションとアプリのアクティビティ

• App activity：Last used the app とその日時（または "Hasn't used the app yet."）、最近の IP アドレスが表示されます。
• Sessions：Sign out of app でユーザーのアプリのセッションを取り消します。"This revokes the user's app session. They'll need to sign in again to unlock doors."（ユーザーのアプリのセッションが取り消されます。ドアを解錠するには再度サインインする必要があります。）注意："Sessions are revoked immediately, but if the user is currently signed in it may take up to 15 minutes before they're fully signed out of the app."（セッションはすぐに取り消されますが、ユーザーが現在サインインしている場合は、アプリから完全にサインアウトされるまで最大 15 分かかることがあります。）セッションは電話番号/メールに紐付けられているため、同じ電話番号/メールを別の施設で使用している人は、その施設でもサインアウトされます。

ユーザーの削除

図 9：危険ゾーン

Delete user を使用すると、Users から行が削除されます。"Their access log history is kept for the audit trail."（アクセスログの履歴は監査証跡として保持されます。）削除すると、そのユーザーのアクセス権もすぐに無効になります。同期されたユーザーの場合、連携サービスを無効にするか行を切り離さない限り、次の同期でその人が再び表示される可能性があることに注意してください。連携サービス全体のユーザーを削除するには、同期と連携 の Bulk delete synced users を使用します。

Performance Hub のスタッフ

図 10：Performance Hub のスタッフのパネル

スタッフのパネルには Synced from Performance Hub IAM というバナーが表示されます。スタッフは、Performance Hub のロールにこの施設が含まれているため自動的に追加され、そのアクセス権がなくなると削除されます。バナーにはスタッフのロールが一覧表示されます。

• 名前、メール、電話番号、人物の種類は Performance Hub IAM で管理され、ここでは読み取り専用です。
• Synced tags（Performance Hub staff や Role: … など）は同期のたびに上書きされます。Custom tags と Notes は引き続き追加できます。
• スタッフはここでは削除できません。Performance Hub IAM で施設へのアクセス権を削除するか、Access enabled をオフにしてドアのアクセス権をすぐに停止します。

Performance Hub のスタッフの同期 を参照してください。

関連ページ

• アプリへの招待
• Access Policies
• Access Policy のスケジュール
• Access Scopes
• 同期と連携
• アクセス判定の仕組み