서명된 가져오기

프로토콜 클라이언트가 인증된 HTTPS 요청을 만들고자 할 때, 표준을 활용할 수 있습니다 서명된 fetch 메커니즘.

서명된 fetch는 다음을 포함하는 요청입니다 인증 체인, 헤더를 통해 표현됩니다. Decentraland 호환 API를 가진 서버는 예를 들어 씬에서의 요청을 허용하거나 또는 생성하기 어댑터.

헤더

서버가 인증 체인을 검증하는 데 필요한 정보는 3개 이상의 헤더로 전달됩니다:

• X-Identity-Timestamp: 그 타임스탬프 필드로, 서명된 페이로드에 포함됩니다(아래 참조).

• X-Identity-Metadata: 그 메타데이터 필드로, 서명된 페이로드에 포함됩니다(아래 참조).

• X-Identity-AuthChain-<index>: 그 JSON으로 직렬화된 인증 단계 <index>, 다음부터 시작하여 0.

전송된 체인은 서버에 의해 검증됩니다 명시된 대로.

본문

요청 본문은 지정되지 않습니다. 서비스는 원하는 어떤 프로토콜이나 형식이든 자유롭게 사용할 수 있습니다.

페이로드

인증 체인 페이로드 서명된 fetch의 경우 다음과 같은 소문자, 콜론으로 구분된 요청 요소 중 일부를 포함하는 문자열입니다:

<method>:<path>:<timestamp>:<metadata>

이 메서드 및 경로 필드들은 요청의 것과 일치해야 하며, 타임스탬프 은(는) 다음과 동일합니다 X-Identity-Timestamp 헤더.

마지막 필드인, 메타데이터, 임의의 내용을 가질 수 있습니다.

예를 들면:

get:/some/path:1682790056:{"some":"custom json"}