アクセス制御

アクセス制御のしくみ

urn:ugs:economy:/v2/project/*/player/*/currencies/gold

urn:ugs:economy:/**/currencies/gold

{	"Sid": "allow-all-ugs",	"Effect": "Allow",	"Action": ["*"],	"Principal": "Player",	"Resource": "urn:ugs:*"},

{	"Sid": "deny-economy-write-access",	"Effect": "Deny",	"Action": ["Write"],	"Principal": "Player",	"Resource": "urn:ugs:economy:/v2/project/*/player/*/currency/gold"},

{	"Sid": "deny-all-economy-access",	"Effect": "Deny",	"Action": ["*"],	"Principal": "Player",	"Resource": "urn:ugs:economy:*"},

アクセス制御の使用方法

ポリシーの例

{	"Sid": "deny-cloud-code-access",	"Effect": "Deny",	"Action": ["*"],	"Principal": "Player",	"Resource": "urn:ugs:cloud-code:/v1/projects/*/scripts/*"},

{	"Sid": "deny-cloud-save-data-write-access",	"Effect": "Deny",	"Action": ["Write"],	"Principal": "Player",	"Resource": "urn:ugs:cloud-save:/v1/data/projects/*/players/*/items**"},

Player

^[A-Za-z0-9][A-Za-z0-9_-]{5,59}$

deny-cloud-save-data-write-access

urn:ugs:cloud-save:/v1/data/projects/*/players/*/items**

エラー応答

{  "title": "Forbidden",  "detail": "Access has been restricted",  "code": 56,  "status": 403,  "type": "https://services.docs.unity.com/docs/errors/#56"}

{  "title": "Forbidden",  "detail": "Principal is not authorized to access resource",  "code": 57,  "status": 403,  "type": "https://services.docs.unity.com/docs/errors/#57"}

expiresAt

{  "title": "Forbidden",  "detail": "Principal is not authorized to access resource",  "code": 57,  "status": 403,  "type": "https://services.docs.unity.com/docs/errors/#57",  "expiresAt": "2023-04-29T18:30:51.243Z"}

expiresAt

アクセス制御でのポリシー選択

{	"Sid": "deny-all-economy-access",	"Effect": "Deny",	"Action": ["*"],	"Principal": "Player",	"Resource": "urn:ugs:economy:*"},{	"Sid": "allow-economy-currencies-access",	"Effect": "Allow",	"Action": ["*"],	"Principal": "Player",	"Resource": "urn:ugs:economy:/v2/**/currencies/*"},{	"Sid": "deny-gold-currency-access-economy",	"Effect": "Deny",	"Action": ["Write"],	"Principal": "Player",	"Resource": "urn:ugs:economy:/v2/**/currencies/gold"},

1. 1 番目のルールは、Economy へのすべてのリクエストをまとめて拒否します。
2. 2 番目のルールは、Economy の

   */currencies/

   API へのすべてのリクエストに対する読み取りおよび書き込みアクセスを許可します。
3. 3 番目のルールは、Economy の

   */currencies/gold

   API への書き込みリクエストに対するアクセスを拒否します。

*/currencies/silver

/currencies/*

*/currencies/gold

*/currencies/gold

ベストプラクティス

デフォルトで拒否

{	"Sid": "deny-all-ugs-access",	"Effect": "Deny",	"Action": ["*"],	"Principal": "Player",	"Resource": "urn:ugs:*:/**"},

最小権限の原則

{	"Sid": "allow-cloud-save-read-access",	"Effect": "Allow",	"Action": ["Read"],	"Principal": "Player",	"Resource": "urn:ugs:cloud-save:/v1/data/**/player/*/items**"},

きめ細かいポリシーの定義

{	"Sid": "allow-economy-silver-readwrite-access",	"Effect": "Allow",	"Action": ["*"],	"Principal": "Player",	"Resource": "urn:ugs:economy:/**/currencies/silver"},{	"Sid": "deny-economy-gold-write-access",	"Effect": "Deny",	"Action": ["Write"],	"Principal": "Player",	"Resource": "urn:ugs:economy:/**/currencies/gold"},

定期的な見直し

REST API

curl -X PATCH https://services.api.unity.com/access/v1/projects/{projectId}/environments/{environmentId}/resource-policy \--header 'Authorization: Basic YOUR_ENCODED_API_KEY' \--header 'Content-Type: application/json' \--data-raw '{     "statements": [    	{            	"Sid": "deny-cloud-save-write-access",            	"Effect": "Deny",            	"Action": ["Write"],            	"Principal": "Player",            	"Resource": "urn:ugs:cloud-save:*"    	}    ]}'

アクセス制御設定のデプロイ

エディターを使用したデプロイ

プロジェクトのリンク

1. Unity エディターで、Edit (編集) > Project Settings (プロジェクト設定) > Services (サービス) の順に選択します。
2. プロジェクトをリンクします。
   • プロジェクトに Unity プロジェクト ID がない場合:
     1. Create a Unity Project ID (Unity プロジェクト ID の作成) > Organizations (組織) の順に選択し、ドロップダウンメニューから組織を選択します。
     2. Create project ID (プロジェクト ID を作成) を選択します。
   • 既存の Unity プロジェクト ID がある場合:
     1. Use an existing Unity project ID (既存の Unity プロジェクト ID を使用) を選択します。
     2. ドロップダウンメニューから組織とプロジェクトを選択します。
     3. Link project ID (プロジェクト ID をリンク) を選択します。

UnityEditor.CloudProjectSettings.projectId

必要なパッケージをインストールする

• Deployment
• Services Tooling

1. Unity エディターの Package Manager (パッケージマネージャー) ウィンドウで、+ (add) (+ (追加)) > Add package by name… (名前でパッケージを追加...) を選択します。

2. com.unity.services.deployment

   を入力します。
3. Add (追加) を選択します。
4. これらのステップを

   com.unity.services.tooling

   について繰り返します。

設定の作成

1. Unity エディターで、Project (プロジェクト) ウィンドウを右クリックし、Create (作成) > Services (サービス) > Access Control Configuration (アクセス制御設定) を選択します。
2. 設定に任意の名前を付けます。
3. Enter を押します。

設定の編集

• Project (プロジェクト) タブで、既存の設定をダブルクリックする。
• Deployment (デプロイ) ウィンドウで、既存のスクリプトを探し、右クリックメニューから Open (開く) を選択する。

CLI を使用したデプロイ

UGS CLI の設定

1. UGS CLI をインストール します。
2. プロジェクト ID と環境を以下のように設定します。
   

   ugs config set project-id <your-project-id>

   
   

   ugs config set environment-name <your-environment-name>

3. アクセス制御 と 環境管理 に必要なロールでサービスアカウントを設定します。認証の取得 を参照してください。

リソースのデプロイ

ugs deploy <path-to-access-control-file>