IoT Central アプリケーションでユーザーとロールを管理する

[アーティクル]
03/01/2024

この記事では、Azure IoT Central アプリケーションでユーザーを追加、編集、および削除する方法について説明します。この記事では、アプリケーションでロールを管理する方法についても説明します。

[アクセス許可] セクションにアクセスして使用するには、Azure IoT Central アプリケーションのアプリ管理者ロールか、管理アクセス許可が含まれているカスタムロールが必要です。 Azure IoT Central アプリケーションを作成したユーザーは、自動的にそのアプリケーションのアプリ管理者ロールに追加されます。

IoT Central REST API を使ってユーザーとロールを管理する方法については、「IoT Central REST API を使用してユーザーとロールを管理する方法」をご覧ください。

ユーザーの追加

ユーザーがアプリケーションにサインインしてアクセスするには、ユーザーアカウントが必要です。 IoT Central では、Microsoft ユーザーアカウント、Microsoft Entra アカウント、Microsoft Entra グループ、および Microsoft Entra サービスプリンシパルがサポートされます。詳細については、Microsoft アカウントのヘルプおよびクイックスタート: Microsoft Entra ID への新しいユーザーの追加に関する記事を参照してください。

IoT Central アプリケーションにユーザーを追加するには、[アクセス許可] セクションの [ユーザー] ページに移動します。
[ユーザー] ページでユーザーを追加するには、[+ ユーザーの割り当て] を選択します。 [ユーザー] ページでサービスプリンシパルを追加するには、[+ Assign service principal]\(+ サービスプリンシパルの割り当て\) を選択します。 [ユーザー] ページで Microsoft Entra グループを追加するには、[+ グループの割り当て] を選択します。 Active Directory グループの名前またはサービスプリンシパルの名前の入力を開始すると、フォームに自動的に入力されます。

Note

サービスプリンシパルと Active Directory グループは、IoT Central アプリケーションに関連付けられている Azure サブスクリプションと同じ Microsoft Entra テナントに属している必要があります。
アプリケーションで組織を使用している場合は、[組織] ドロップダウンメニューからユーザーに割り当てる組織を選択します。
ロールドロップダウンメニューからユーザーに対するロールを選択します。ロールの詳細については、この記事の「ロールの管理」セクションを参照してください。

利用可能なロールは、ユーザーが関連付けられている組織によって異なります。ルート組織に関連付けられているユーザーにアプリのロールを割り当て、階層内の他の組織に関連付けられているユーザーに組織のロールを割り当てることができます。

Note

他のユーザーを追加する権限が付与されるカスタムロールのユーザーは、自分のロールと同じかそれよりも低い権限を持つロールにのみユーザーを追加できます。

新しいユーザーを招待する際には、アプリケーションの URL を相手に伝え、サインインしてもらう必要があります。ユーザーが初めてサインインすると、ユーザーのマイアプリページにアプリケーションが表示されます。

Note

ユーザーを Microsoft Entra ID から削除してから追加し直した場合、そのユーザーは IoT Central アプリケーションにサインインできなくなります。アクセスを再び有効にするには、アプリケーションの管理者がアプリケーションでもユーザーを削除してから再び追加する必要があります。

Microsoft Entra グループとサービスプリンシパルには、次の制限が適用されます。

各 IoT Central アプリケーションの Microsoft Entra グループの合計数は、20 を超えることはできません。
同じ Microsoft Entra テナントからの一意の Microsoft Entra グループの合計数は、すべての IoT Central アプリケーション全体で 200 を超えることはできません。
Microsoft Entra グループの一部であるサービスプリンシパルには、アプリケーションへのアクセス権が自動的に付与されません。サービスプリンシパルは明示的に追加する必要があります。

ユーザーに割り当てられているロールと組織を編集する

ロールと組織は、割り当てられた後に変更することはできません。ユーザーまたは組織に割り当てられているロールを変更するには、ユーザーを削除してから、別のロールまたは組織を使用してユーザーを追加します。

Note

割り当てられたロールは IoT Central アプリケーションに固有であり、Azure portal から管理することはできません。

ユーザーを削除する

ユーザーを削除するには、ユーザーページで 1 つまたは複数のチェックボックスを選択します｡次に、 [削除] を選択します。

ロールの管理

"ロール" を使うと、組織内のだれが IoT Central でさまざまなタスクを実行できるかを制御できます。アプリケーションのユーザーに割り当てることができる組み込みロールが 3 つあります。より詳細な制御が必要な場合は、カスタムロールの作成を行うこともできます。

アプリの管理者

アプリの管理者ロールのユーザーは、課金を含め、アプリケーションのすべての部分を管理および制御できます。

アプリケーションを作成したユーザーは、自動的にアプリの管理者ロールに割り当てられます。 アプリの管理者ロールには、少なくとも 1 人のユーザーが常に存在している必要があります。

アプリビルダー

アプリビルダー ロールのユーザーは、アプリのすべての部分を管理できますが、[アプリケーション] または [データのエクスポート] タブで変更を加えることはできません。

アプリのオペレーター

アプリのオペレーター ロールのユーザーは、デバイスの正常性と状態を監視できます。デバイステンプレートに変更を加えたり、アプリケーションを管理したりすることはできません。オペレーターはデバイスの追加と削除、デバイスセットの管理、分析とジョブの実行が可能です。

組織管理者

このロールは、アプリケーションに組織を追加すると、IoT Central によって自動的に追加されます。このロールは、組織の管理者が、請求先、ブランド化、カラー設定、API トークン、登録グループ情報などのアプリケーション全体にわたる機能にアクセスすることを制限します。

組織の管理者ロールのユーザーは、アプリケーションにユーザーを招待したり、組織階層内にサブ組織を作成したり、組織内のデバイスを管理したりすることができます。

組織のオペレーター

このロールは、アプリケーションに組織を追加すると、IoT Central によって自動的に追加されます。このロールは、組織のオペレーターがアプリケーション全体の機能にアクセスすることを制限します。

組織のオペレーター ロールのユーザーは、デバイスの追加、コマンドの実行、デバイスデータの表示、ダッシュボードの作成、デバイスグループの作成などのタスクを実行することができます。

組織ビューアー

このロールは、アプリケーションに組織を追加すると、IoT Central によって自動的に追加されます。

組織ビューアーの役割を持つユーザーは、デバイスとそのデータ、組織のダッシュボード、デバイスグループ、デバイステンプレートなどの項目を表示できます。

カスタムロールを作成する

ソリューションに詳細なアクセス制御が必要な場合は、カスタムのアクセス許可セットを使用してロールを作成できます。カスタムロールを作成するには、アプリケーションの [アクセス許可] セクションの [ロール] ページに移動し、次のオプションのいずれかを選びます。

[+ 新しいロール] を選択し、ロールの名前と説明を追加し、ロールの種類に [アプリケーション] または [組織] を選択します。このオプションを使用すると、ロールの定義を最初から作成できます。
既存のロールに移動し、[コピー] を選択します。このオプションを使用すると、カスタマイズ可能な既存のロール定義から始めることができます。

警告

ロールの作成後にロールの種類を変更することはできません。

ユーザーをアプリケーションに招待するときに、ユーザーを次のように関連付けます。

ルート組織と関連付けると、アプリケーション ロールのみを使用できます。
その他の組織と関連付けると、組織ロールのみを使用できます。

組み込みロールにユーザーを追加するのと同じ方法で、ユーザーをカスタムロールに追加できます。

カスタムロールのオプション

カスタムロールを定義する場合は、ユーザーがそのロールのメンバーである場合に付与されるアクセス許可のセットを選択します。一部のアクセス許可は他のアクセス許可に依存しています。たとえば、ロールに [Update personal dashboards]\(個人用ダッシュボードの更新\) アクセス許可を追加すると、[View personal dashboards]\(個人用ダッシュボードの表示\) アクセス許可が自動的に追加されます。次の表は、使用可能なアクセス許可とその依存関係をまとめたもので、カスタムロールを作成するときに使用できます。

デバイスの管理

デバイステンプレートのアクセス許可

名前	依存関係
ビュー	なし
管理	の表示その他の依存関係: デバイスインスタンスの表示
フルコントロール	表示、管理その他の依存関係: デバイスインスタンスの表示

デバイスインスタンスのアクセス許可

名前	依存関係
ビュー	なしその他の依存関係: デバイステンプレートおよびデバイスグループの表示
更新プログラム	の表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示
作成	の表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示
削除	の表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示
コマンドの実行	更新、表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示
生データを表示する	の表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示
アップロードされたデバイスファイルの表示	の表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示
アップロードされたデバイスファイルの削除	の表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示
フルコントロール	表示、更新、作成、削除、コマンドの実行、生データの表示その他の依存関係: デバイステンプレートおよびデバイスグループの表示

デバイスグループのアクセス許可

名前	依存関係
ビュー	なしその他の依存関係: デバイステンプレートおよびデバイスインスタンスの表示
更新プログラム	の表示その他の依存関係: デバイステンプレートおよびデバイスインスタンスの表示
作成	表示、更新その他の依存関係: デバイステンプレートおよびデバイスインスタンスの表示
削除	の表示その他の依存関係: デバイステンプレートおよびデバイスインスタンスの表示
フルコントロール	表示、更新、作成、削除その他の依存関係: デバイステンプレートおよびデバイスインスタンスの表示

デバイス接続の管理のアクセス許可

名前	依存関係
インスタンスの読み取り	なしその他の依存関係: デバイステンプレート、デバイスグループ、デバイスインスタンスの表示
インスタンスの管理	インスタンスの読み取りその他の依存関係: デバイステンプレート、デバイスグループ、デバイスインスタンスの表示
グローバルの読み取り	なし
グローバルの管理	グローバルの読み取り
フルコントロール	インスタンスの読み取り、インスタンスの管理、グローバルの読み取り、グローバルの管理その他の依存関係: デバイステンプレート、デバイスグループ、デバイスインスタンスの表示

Edge の配置マニフェスト

名前	依存関係
インスタンスの読み取り	なしその他の依存関係: デバイステンプレート、デバイスグループ、デバイスインスタンスの表示
インスタンスの管理	インスタンスの読み取りその他の依存関係: デバイステンプレート、デバイスグループ、デバイスインスタンスの表示
グローバルの読み取り	なし
グローバルの管理	グローバルの読み取り
フルコントロール	インスタンスの読み取り、インスタンスの管理、グローバルの読み取り、グローバルの管理その他の依存関係: デバイステンプレート、デバイスグループ、デバイスインスタンスの表示。デバイスインスタンスの更新

ジョブのアクセス許可

名前	依存関係
ビュー	なしその他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループの表示
更新プログラム	の表示その他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループの表示
作成	表示、更新その他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループの表示
削除	の表示その他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループの表示
実行	の表示その他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループの表示。デバイスインスタンスの更新。デバイスインスタンスでのコマンドの実行
フルコントロール	表示、更新、作成、削除、実行その他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループの表示。デバイスインスタンスの更新。デバイスインスタンスでのコマンドの実行

ルールのアクセス許可

名前	依存関係
ビュー	なしその他の依存関係: デバイステンプレートの表示
更新プログラム	の表示その他の依存関係: デバイステンプレートの表示
作成	表示、更新その他の依存関係: デバイステンプレートの表示
削除	の表示その他の依存関係: デバイステンプレートの表示
フルコントロール	表示、更新、作成、削除その他の依存関係: デバイステンプレートの表示

アプリの管理

アプリケーション設定のアクセス許可

名前	依存関係
ビュー	なし
更新プログラム	ビュー
コピー	の表示その他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループ、ダッシュボード、データエクスポート、ブランド、ヘルプリンク、カスタムロール、ルールの表示
削除	ビュー
フルコントロール	表示、更新、コピー、削除その他の依存関係: デバイステンプレート、デバイスグループ、アプリケーションダッシュボード、データエクスポート、ブランド化、ヘルプリンク、カスタムロール、ルールの表示

アプリケーションテンプレートのエクスポートのアクセス許可

名前	依存関係
ビュー	なし
Export	の表示その他の依存関係: デバイステンプレート、デバイスインスタンス、デバイスグループ、ダッシュボード、データエクスポート、ブランド、ヘルプリンク、カスタムロール、ルールの表示
フルコントロール	表示、エクスポートその他の依存関係: デバイステンプレート、デバイスグループ、アプリケーションダッシュボード、データエクスポート、ブランド化、ヘルプリンク、カスタムロール、ルールの表示

デバイスファイルのアップロードのアクセス許可

名前	依存関係
ビュー	なし
管理	ビュー
フルコントロール	表示、管理

課金のアクセス許可

名前	依存関係
管理	なし
フルコントロール	管理

監査ログのアクセス許可

名前	依存関係
ビュー	なし
フルコントロール	ビュー

注意事項

監査ログを表示するアクセス許可を付与されたユーザーは、ログにリスト表示されているエンティティを表示または変更するアクセス許可を持っていない場合でも、すべてのログエントリを表示できます。そのため、ログを表示できるすべてのユーザーは、変更されたエンティティの ID と変更を表示できます。

ユーザーとロールの管理

カスタムロールのアクセス許可

名前	依存関係
ビュー	なし
更新プログラム	表示
作成	表示、更新
削除	ビュー
フルコントロール	表示、更新、作成、削除

ユーザー管理のアクセス許可

名前	依存関係
ビュー	なしその他の依存関係: カスタムロールの表示
追加	の表示その他の依存関係: カスタムロールの表示
削除	の表示その他の依存関係: カスタムロールの表示
フルコントロール	表示、追加、削除その他の依存関係: カスタムロールの表示

組織の管理アクセス許可

名前	依存関係
ビュー	なし
更新プログラム	表示
作成	表示、更新
削除	ビュー
フルコントロール	表示、更新、作成、削除

Note

他のユーザーを追加する権限が付与されるカスタムロールのユーザーは、自分のロールと同じかそれよりも低い権限を持つロールにのみユーザーを追加できます。

アプリのカスタマイズ

アプリケーションダッシュボードのアクセス許可

名前	依存関係
ビュー	なし
更新プログラム	表示
作成	表示、更新
削除	ビュー
フルコントロール	表示、更新、作成、削除

アプリケーションダッシュボードのアクセス許可

名前	依存関係
ビュー	なし
更新プログラム	表示
作成	表示、更新
削除	ビュー
フルコントロール	表示、更新、作成、削除

データエクスプローラーアクセス許可

名前	依存関係
ビュー	なしその他の依存関係: デバイスループ、デバイスンプレート、デバイスンスタンスの表示
更新プログラム	の表示その他の依存関係: デバイスループ、デバイスンプレート、デバイスンスタンスの表示
作成	表示、更新その他の依存関係: デバイスループ、デバイスンプレート、デバイスンスタンスの表示
削除	の表示その他の依存関係: デバイスループ、デバイスンプレート、デバイスンスタンスの表示
フルコントロール	表示、更新、作成、削除その他の依存関係: デバイスループ、デバイスンプレート、デバイスンスタンスの表示

ブランド、favicon、および色のアクセス許可

名前	依存関係
ビュー	なし
更新プログラム	ビュー
フルコントロール	表示、更新

ヘルプリンクのアクセス許可

名前	依存関係
ビュー	なし
更新プログラム	ビュー
フルコントロール	表示、更新

アプリの拡張

データのエクスポートのアクセス許可

名前	依存関係
ビュー	なし
更新プログラム	表示
作成	表示、更新
削除	ビュー
フルコントロール	表示、更新、作成、削除

API トークンのアクセス許可

名前	依存関係
ビュー	なしその他の依存関係: カスタムロールの表示
作成	の表示その他の依存関係: カスタムロールの表示
削除	の表示その他の依存関係: カスタムロールの表示
フルコントロール	表示、作成、削除その他の依存関係: カスタムロールの表示