ACL エントリー
ACL は ACL エントリーから構成されます。さらに、ACL エントリーはサブジェクトとアクションから構成されます。
ここでは、ACL エントリーを設定して ACL を変更する方法について説明します。
ACL エントリーのクラス構成
Kii Cloud SDK で ACL エントリーを扱う際に使用するクラスの構成を以下に示します。
サブジェクトとアクション
ACL エントリーはサブジェクトとアクションを持ちます。
サブジェクト
サブジェクトは「誰が」に相当する情報です。
サブジェクトには以下の 5 つのいずれかを指定することができます。
実在するユーザー
実在するグループ
実在する Thing
匿名ユーザー（ログインしていない状態のユーザー、ログインした任意のユーザー、アクセストークンを持たない Thing、または、アクセストークンを持った Thing）
ログイン済みの全ユーザー（ログインした任意のユーザー、または、アクセストークンを持った Thing）
「匿名ユーザー」と「ログイン済みの全ユーザー」は ACL エントリーのサブジェクトにだけ指定できる概念で、ログイン等で使用できるものではありません。クライアント SDK では、KiiAnonymousUser と KiiAnyAuthenticatedUser が該当しますが、これらは KiiSubject とだけ関連を持ち、KiiUser との関連はない点に注意してください。
アクション
アクションは「何をする」に相当する情報です。
ACL エントリーに設定できるアクションは以下のとおりです。アクション名は SDK によって異なりますが、内容は同じです。表に挙げた名前は REST API で指定するものです。
| 対象 | アクション | 説明 |
|---|---|---|
| スコープ | CREATE_NEW_BUCKET | スコープ内に新たな Bucket を追加。 |
| CREATE_NEW_TOPIC | スコープ内に新たなトピックを追加。 | |
| Bucket | CREATE_OBJECTS_IN_BUCKET | Bucket 内に新たな KiiObject を追加。 |
| QUERY_OBJECTS_IN_BUCKET | Bucket 内の KiiObject を検索。 | |
| READ_OBJECTS_IN_BUCKET | Bucket 内の KiiObject を読み取り。 | |
| DROP_BUCKET_WITH_ALL_CONTENT | Bucket 内の KiiObject とともに Bucket を削除。 | |
| KiiObject | READ_EXISTING_OBJECT | KiiObject を読み取り。 |
| WRITE_EXISTING_OBJECT | KiiObject を更新および削除。 | |
| トピック | SUBSCRIBE_TO_TOPIC | トピックを講読。 |
| SEND_MESSAGE_TO_TOPIC | トピックにプッシュメッセージを送信。 |
スコープの ACL は REST API でのみ変更できるため、スコープのアクションは上記のクラス図に含まれません。
Bucket、KiiObject、トピックのそれぞれについて設定できる項目が異なります。BucketAction が Bucket に対する操作、ObjectAction が KiiObject に対する操作、TopicAction がトピックに対する操作です。
ACL の変更リクエスト
ACL を変更するときは、クライアント側で ACL の差分を作成し、それを ACL の変更リクエストとして送信します。
たとえば、以下のようにサーバー側の KiiObject に 4 件の ACL エントリーがあったとき、「井田」の「書き込み」の権限を削除、「宇田」の「読み込み」の権限を新規に追加したいとします。
Kii Cloud SDK の KiiACLEntry クラスは、サブジェクトとアクションの他に、権限の追加または削除の区別を示す boolean 値 grant を属性として持っています。
クライアントでは、追加したい権限に対して grant=true の ACL エントリーを、削除したい権限に対して grant=false の ACL エントリーをそれぞれ作成します。ACL エントリーをサーバーに送信すると、サーバー上の ACL が変更されます。
開発者ポータルでの変更
Bucket の ACL に限り、開発者ポータルからカスタマイズできます。
詳細は Bucket の ACL を変更する をご覧ください。