이미지 업데이트 생성 URL 파라미터
AWS S3
s3://<username>:<password>@<bucket>/<folder>/?<parameters>Authentication
사용자 이름 = AWS 액세스 키
비밀번호 = AWS 비밀 액세스 키
https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html
선택적 쿼리 파라미터
| 이름 | 설명 | 기본값 |
| handlers | 버킷 동기화에 사용되는 핸들러 수를 지정합니다. | 10 |
| 영역 | 버킷이 위치한 AWS 영역을 식별합니다. | eu-west-1 |
| requesttimeout | 이미지 가져오기 요청이 타임아웃될 때까지 기다리는 시간을 지정합니다. | 2m(2분) |
Steamcmd
steam://<username>:<password>@install/<appid>/Authentication
사용자 이름 = Steam 사용자 이름('익명'으로 설정 가능)
비밀번호 = Steam 비밀번호(‘익명’ 사용자인 경우 공백으로 설정 가능)
Steam Guard 코드 = guardcode 사용법은 선택적 쿼리 파라미터 참고
https://help.steampowered.com/en/faqs/view/06B0-26E6-2CF8-254C
선택적 쿼리 파라미터
| 이름 | 설명 | 기본값 |
| platformtype | convar @sSteamCmdForcePlatformType - 유효한 옵션은 windows, linux, macos입니다. | 빌드박스의 플랫폼 유형입니다. 다음과 같은 경우 Steam 저장소의 잘못된 구성이 원인일 수 있습니다.
|
| platformbitness | convar @sSteamCmdForcePlatformBitness - 유효한 옵션은 32와 64입니다. | 필드박스의 플랫폼 비트입니다(일반적으로 64비트). |
| guardcode | 로그인 커맨드에 전달된 Steam Guard 코드입니다. | 해당 없음 |
| beta | beta가 app_update 커맨드의 -beta 파라미터에 전달됨 | 해당 없음 |
| betapassword | password가 app_update 커맨드의 -betapassword 파라미터에 전달됨 | 해당 없음 |
| appmod | mod가 app_set_config 커맨드의 mod 파라미터에 전달됨 | 해당 없음 |
Google Cloud Storage
gs://<bucket>/<folder>?credentials=<creds>Authentication
버킷에 대한 권한을 부여하는 자격 증명입니다. URL 인코딩된 Google 서비스 계정 JSON 자격 증명이어야 합니다.
https://cloud.google.com/iam/docs/keys-create-delete
선택적 쿼리 파라미터
| 이름 | 설명 | 기본값 |
| handlers | 버킷 동기화에 사용되는 핸들러 수를 지정합니다. | 10 |
| requesttimeout | 요청에 사용된 타임아웃 값입니다. | 2분 |
Tencent Cloud Object Storage
cos://<username>:<password>@<bucket>/<folder>Authentication
사용자 이름 = COS SecretId
비밀번호 = COS SecretKey
https://www.tencentcloud.com/document/product/436/45241?lang=en
선택적 쿼리 파라미터
| 이름 | 설명 | 기본값 |
| handlers | 버킷 동기화에 사용되는 핸들러 수를 지정합니다. | 10 |
| 영역 | 버킷이 위치한 Tencent Cloud 영역을 식별합니다. | ap-shanghai |
| requesttimeout | 요청에서 사용할 타임아웃 값입니다. | 2m(2분) |
URL 인코딩 주의 사항
사용자 이름과 비밀번호 자격 증명이 특수 문자를 포함하는 경우, 전체 URL을 인코딩하기 전에 자격 증명을 URL 인코딩해야 합니다(인코딩한 자격 증명으로 URL을 별도로 인코딩). 이는 모든 URL 유형에 해당하며, URL 파라미터를 사용하여 API 호출을 할 때 반드시 수행해야 합니다. Clanforge WebPanel을 사용할 때는 인코딩을 수행할 필요가 없습니다.
AWS S3 URL 인코딩 예제
다음 예제는 AWS S3 URL 파라미터를 이미지 생성 업데이트 API 호출에 어떻게 사용할 수 있는지와 인코딩을 수행하는 방법을 설명합니다.
예를 들어, 다음과 같은 S3 URL이 있을 수 있습니다. s3://my%user:my%password\@bucket/key. 인코딩하기 전 사용자 이름은 my%user이고 비밀번호는 my%password입니다.
URL 인코딩 후 사용자 이름은 my%25user가 되고 비밀번호는 my%25password가 됩니다.
- 인코딩한 자격 증명을 사용하여 S3 URL을 다음과 같이 구성합니다.
s3://my%25user:my%25password@bucket/key - 버킷 URL을 API 요청에 사용하려면 먼저 전체 URL(미리 인코딩한 자격 증명 포함)을 다시 인코딩합니다. 인코딩한 후 전체 버킷 URL은
s3%3A%2F%2Fmy%25user%3Amy%25password%40bucket%2Fkey입니다. - 마지막으로 이 2단계 인코딩 프로세스를 마치고 나면 S3 버킷 URL을 API 요청에 사용할 수 있습니다.
https://api.multiplay.co.uk/cfp/v1/imageupdate/create?imageid=1249&machineid=95394&accountserviceid=1337&desc=alpha-build&url=s3%3A%2F%2Fmy%25user%3Amy%25password%40bucket%2Fkey.`