Organization token¶
Organization token とは¶
Organization token とは Mapray Cloud のリソースにアクセスする権限を設定できる Access token です。
組織に紐づいたデータセット、ユーザなどの操作に制限ができます。
Organization 管理者が Organization token の作成・更新・削除を行えます。
作成数の上限¶
Organization に紐づいた Organization token の数に制限があります。
作成できる Organization token の数は 500 個です。
Token scopes による権限の制限¶
「Token scopes」とは、操作が可能な権限です。
| Token scopes | スコープ | 説明 |
|---|---|---|
| Dataset Read | dataset:read | データセットの情報、地図データを取得できます。 |
| Dataset Create | dataset:create | データセットを作成できます。 |
| Dataset Update | dataset:update | データセットを更新できます。 |
| Dataset Delete | dataset:delete | データセットを削除できます。 |
| Token Read | token:read | Organization token の情報を取得できます。 |
| Token Create | token:create | Organization token を作成できます。 |
| Token Update | token:update | Organization token を更新できます。 |
| Token Delete | token:delete | Organization token を削除できます。 |
| Member Read | member:read | 組織に所属しているユーザの情報を取得できます。 |
| Member Create | member:create | 組織にユーザを招待できます。 |
| Member Update | member:update | 招待を受諾したユーザのロールを変更できます。 |
| Member Delete | member:delete | 招待を受諾したユーザを脱退できます。 |
| Organization Read | organization:read | 組織の情報を取得できます。 |
Organization token の作成¶
-
「Tokens」ページの、「Organization token」タブから、「New Organization Token」ボタンをクリックします。
-
ダイアログが表示されたら、必要事項を入力します。
Organization token に付与したい権限の「Token scopes」を選択して、「OK」ボタンをクリックします。プロパティ 説明 Name 任意の名前を指定します。2文字以上128文字以下で入力してください。 Token scopes 付与したい権限を指定します。 Token restrictions アクセス元 IP アドレスを複数設定できます。 設定しない場合は制限を行いません。 Allowed Domains アクセスを許可するドメインを複数設定できます。設定しない場合は制限を行いません。 Expires in 有効期限を作成日時からの秒数で設定します。設定しない場合は無期限で使用できます。 
-
Organization token は作成時に出るこの画面からのみ確認でき、生成時以降は 再度表示できません。
必ずこれを記録して、適切に管理するようにご注意ください。
Organization token の Token scopes や名前はいつでも変更、削除が可能です。もし、Organization token が流出した場合、Token scopes に設定されている権限の操作が出来てしまうため、削除して再発行を行ってください。
Organization token を発行するときに「Token restrictions」を指定することも可能です。「Token restrictions」はアクセス元IPアドレス制限に使用します。ただし、モバイルアプリのように、パブリックのインターネット経由でアクセスする場合は、IP アドレスが変動し制限できないため、入力しないようお願いします。