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