액세스 제어

액세스 제어 작동 방식

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. 첫 번째 규칙은 Economy에 대한 모든 요청을 일반적으로 거부합니다.
2. 두 번째 규칙은 Economy의

   */currencies/

   API에 대한 모든 요청에 대해 읽기/쓰기 액세스를 허용합니다.
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 > Organizations를 선택한 다음 드롭다운 메뉴에서 조직을 선택합니다.
     2. Create project ID를 선택합니다.
   • Unity 프로젝트 ID가 있는 경우 다음 단계를 진행합니다.
     1. Use an existing Unity project ID를 선택합니다.
     2. 드롭다운 메뉴에서 조직과 프로젝트를 선택합니다.
     3. Link project 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 키를 누릅니다.

구성 편집

• 프로젝트 탭에서 기존 구성을 더블 클릭합니다.
• 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>