ユーザータイプの一覧
管理者ロールと共同管理者ロール
管理者と共同管理者は、独立したユーザータイプではなく、管理対象ユーザーに割り当てることができるロールです。いずれかのロールを付与する前に、ユーザーはまず管理対象ユーザーである必要があります。 管理者または共同管理者のロールを付与された管理対象ユーザーは、を使用してBox Enterpriseを管理できます。また、セキュリティポリシーの管理やレポートの実行、統合の構成など、他のユーザーには許可されていない操作を実行することができます。アプリケーションによっては、操作に管理者レベルの権限が必要です。例えば、を監視するセキュリティアプリケーションを操作するには、レポート権限を持つ管理者または共同管理者である必要があります。
管理対象ユーザー
管理対象ユーザーは企業に所属し、標準のBoxライセンスを購入しています。企業ごとに固有のEnterprise IDがあり、そのIDをすべての管理対象ユーザーが共有します。管理対象ユーザーは通常、同じメールドメインを共有します。外部ユーザー
外部ユーザーは、組織外から参加するコラボレータです。つまり、管理コンソールで作成されていないアカウントを所有し、管理対象ドメインに関連付けられていないメールアドレスを持つBoxユーザーです。外部ユーザーは、別の企業に所属している場合もあれば、企業と関係のない無料の個人用Boxアカウントを持っている場合もあります。 管理者は、外部ユーザーのアカウント設定や所有するコンテンツを管理できません。しかし、外部ユーザーとのコラボレーションを管理することはでき、たとえば、企業のコンテンツへのアクセスを許可または取り消すことができます。外部ユーザーは管理コンソールの [ユーザーとグループ] > [外部ユーザー] に表示されます。外部ユーザーがまだ別のBox Enterpriseに所属していなければ、管理者はその外部ユーザーをして、自分の組織の管理対象ユーザーにすることができます。管理対象外ユーザー
管理対象外ユーザーは、以下に該当するBoxユーザーです。- 管理者または共同管理者からは独立して取得され、お客様のBox組織に所属していない、ライセンスのない個人用Boxアカウントを持っている
- お客様のドメインまたは確認済みドメイン (お客様の組織が所有または管理するドメイン) のメールアドレスを使用している
サービスアカウント
サービスアカウントは、Box Enterprise内のアプリケーションを表すプログラム上のユーザーです。ログイン資格情報を使用せずにサーバー間の認証を行うため、バックエンドの統合や自動化ワークフローに最適です。 * 1企業につき1つ。Enterprise設定を管理してアプリケーションを承認できます。** 承認されたアプリケーション1つにつき1つ。コンテンツとプロセスの所有、App Userの作成と管理ができます。
使用するタイミング
- コンテンツの移行: オンプレミスとクラウドのシステム間でコンテンツを移行します。
- イベントの監視: コンプライアンスの順守やワークフローのトリガーを目的としてEnterprise Eventを監視します。
- コンテンツの配布: 認証ステータスにかかわらず、ファイルをアップロードしてユーザーと共有します。
- システムの統合: オンプレミスのシステムとデバイスをBoxに接続します。
- コンテンツのアーカイブ: アクセス頻度の低いコンテンツを格納します。
作成
サービスアカウントは、管理者が管理コンソールでJWTまたはCCGアプリケーションをしたときに自動的に生成されます。お客様が手動で作成することはありません。 Boxはサービスアカウントに次の形式のメールアドレスを割り当てます。AutomationUser_AppServiceID_RandomString@boxdevedition.com
例: AutomationUser_123456_6jCo6Pqwo@boxdevedition.com。アンダースコアの間の数字はサービスIDで、アプリののURL (例: https://example.app.box.com/developers/console/app/123456) にあるIDと一致します。
サービスアカウントのメールアドレスは、内のアプリの [アプリの詳細] タブで確認できます。
コンテンツの表示
プライマリ管理者のみがサービスアカウントのコンテンツを表示できます。- 管理コンソールでを開きます。
- アプリケーション名を検索します。
- 検索結果を右クリックし、[ユーザーのアカウントにログインする] を選択します。
共同管理者はサービスアカウントとしてログインできません。これは共同管理者がお互いに管理できないことを反映しています。
権限とコラボレーション
サービスアカウントが呼び出せるAPIエンドポイントは、で構成されたによって決まります。適切なスコープが構成されていると、サービスアカウントは管理者レベルのアクションを実行できます。 サービスアカウントには独自のフォルダツリーがあり、最初は空になっています。既存のコンテンツにアクセスできるようにするには、以下の方法を使用します。- メールを使用: 他のコラボレータを招待する場合と同様に、割り当てられたメールアドレスを使用してサービスアカウントを招待します。
- APIを使用: サービスアカウントのユーザーID (によって返されます) を指定して、を使用します。
space_amountパラメータを指定してを呼び出します。
App User
App Userは、サービスアカウントがAPI経由で作成するプログラム上のユーザーです。サービスアカウントと同様、App Userはログイン資格情報を持たず、アプリケーションを通じたBoxとのやり取りのみ可能です。それぞれのApp Userに独自のフォルダツリーが用意されるため、ユーザーごとにコンテンツを分離できます。 App Userは自身が作成したアプリケーションと関連付けられており、別のアプリケーションに転送することはできません。使用するタイミング
- 顧客ポータル: Boxアカウントがなくても機密ドキュメントにアクセスしたり機密ドキュメントを保存したりできる場所を顧客や患者に提供します
- ベンダーポータル: 価格表、契約書、マーケティング資料などのコンテンツをベンダーのレベル別に整理してパートナーに配布します
- ブランド設定されたアプリケーション: ユーザーごとの権限、監査、レポートを備えた顧客向け機能を開発します。は、金融サービスや医療など規制の厳しい業界で特に価値を発揮します
- IDのマッピング: 独自のIDプロバイダ (Auth0やOktaなど) から個々のBoxユーザーアカウントにユーザーをマッピングします
作成
前提条件: JWTまたはCCGアプリケーションが管理コンソールでされる必要があります。これにより、サービスアカウントが用意されます。 App Userを作成するには、サービスアカウントのアクセストークンを使用して、を呼び出します。is_platform_access_only本文パラメータをtrueに設定してください。そうしないと、代わりに管理対象ユーザーが作成されます。
Boxは各App Userに次の形式のメールアドレスを割り当てます。AppUser_AppServiceID_RandomString@boxdevedition.com
一連の手順とコードサンプルについては、を参照してください。
コンテンツの表示
App Userは管理コンソールの次の2か所に表示されます。- [ユーザーとグループ] タブ: 表示オプションボタンを使用し、[ロール] > [App User] でフィルタをかけます。
- コンテンツマネージャ: 名前またはメールでApp Userを検索して、フォルダツリーを閲覧します。
権限とコラボレーション
App Userは、コラボレータとして明示的に追加しない限り、サービスアカウントのフォルダツリーや他のコンテンツを見ることができません。 App Userにはそれぞれ独自のフォルダツリーがあり、最初は空になっています。App Userがコンテンツにアクセスできるようにするには、以下の方法を使用します。- メールを使用: 割り当てられたメールアドレスを使用して、App Userを招待します。
- APIを使用: ターゲットコンテンツへのアクセス権限をすでに持っているユーザーのアクセストークンとApp UserのIDを指定して、を使用します。
サービスアカウントとApp Userの使い分け
この決定ガイドを参考にして、アプリケーションに適した手法を選択してください。As-User
OAuth 2.0、JWT、またはCCG認証を使用する場合は、as-userコールを実行して、別のユーザーの代理になることができます。アプリケーションが当初、自分自身またはサービスアカウントとして認証されたものだとしても、後続のコールで別のユーザーに成り代わることができます。
これは、フォルダの再編成や従業員のプロビジョニングなどの管理タスクを自動化する場合に便利です。as-userコールを有効にするには、で適切なスコープをオンにします。
