서명된 로그인

Signed Login 전송은 서버가 클라이언트를 섬에 할당하는 방식을 사용자 지정하고, 자신의 아키텍처에서 Archipelago를 대체하거나 감싸서 사용하고자 할 때 사용할 수 있습니다.

실시간 백엔드에 직접 연결하는 대신, Signed Login은 서명된 fetch 연결 문자열을 얻기 위한 것입니다. 이 중간 단계는 서버가 원하는 어떤 할당 전략이든 사용할 수 있게 해줍니다.

Signed Login URI는 다음과 같은 형식을 가집니다:

signed-login:https://comms.example.com/auth&param=value

다음 뒤의 부분 signed-login: 접두사 뒤에는 유효한 URL이면 무엇이든 올 수 있습니다.

사용법

Signed Login 요청은 다음을 사용하여 구성됩니다 서명된 fetch 메커니즘입니다.

응답은 성공 시 상태 코드가 200 이며, 다음을 포함하는 JSON 본문을 가집니다 적어도 다음 필드를 포함합니다:

필드	타입	값
fixedAdapter	string	할당된 전송 URI(예: livekit: 또는 ws-room:)

예를 들면:

{ 
  fixedAdapter: "ws-room:wss://comms.example.com/rooms/17"
}

실패한 경우, 응답은 적절한 상태 코드를 가질 수 있으며 다음을 포함하는 JSON 본문을 가질 수 있습니다 적어도 다음 필드를 포함합니다:

필드	타입	값
메시지	string	(선택 사항) 실패에 대한 설명 또는 오류 코드.

JSON 본문에 추가 필드가 포함된 응답도 유효하며, 오류의 내용은 메시지 미정으로 남겨집니다. 구현체는 이 유연성을 활용하여 signed-login: 자신의 애플리케이션에 적절하다고 판단되는 방식으로 통합할 수 있습니다.