본문으로 건너뛰기

OSS 문제 해결

브라우저에서 Admin Console을 로드할 수 없습니다 (Crypto.subtle is unavailable... 오류 표시)​

Admin Console은 Web Crypto API를 사용하며, 이는 보안 컨텍스트, 즉 HTTPS 또는 localhost에서의 HTTP가 필요합니다.

IP 주소나 커스텀 도메인으로 HTTP를 사용할 경우, 브라우저에서 Admin Console을 로드할 수 없습니다.

커스텀 도메인을 사용 중인데, 브라우저에서 Admin Console을 로드할 수 없습니다 ("code": "oidc.invalid_redirect_uri" 오류 표시)​

localhost가 아닌 커스텀 도메인을 사용하는 경우, 환경 변수 ENDPOINT를 Logto URL로 설정해야 합니다. 이는 OIDC에서 Redirect URI에 대한 엄격한 요구 사항 때문입니다. 자세한 내용은 구성을 참고하세요.

Logto 앞단에 HTTPS 프록시(예: Nginx)를 사용 중인데, 로그인에 실패합니다 (TypeError: Failed to fetch 오류 표시)​

  • 먼저, 노드 환경 변수 TRUST_PROXY_HEADER를 true로 설정했는지 확인하세요. 자세한 내용은 구성을 참고하세요.
  • 또한, 프록시 설정에서 X-Forwarded-Proto 헤더를 https로 설정해야 합니다. 자세한 내용은 TLS 오프로딩 프록시 신뢰하기를 참고하세요.

CORS 문제에 직면했습니다.​

  • ADMIN_ENDPOINT가 지정되지 않은 경우, Logto에서는 localhost:[admin-port]가 교차 출처 리소스 공유 (CORS)를 수행할 수 있도록 허용됩니다.
  • ADMIN_ENDPOINT가 지정된 경우, 해당 ADMIN_ENDPOINT의 origin에서 오는 요청만 허용됩니다.

이 오류는 무엇인가요? Error: Invalid id token​

토큰을 잘못 다루지 않았다면, 대부분의 경우 서버 시간과 클라이언트 시간이 일치하지 않아 발생합니다. 서버와 클라이언트의 시간을 동기화한 후 다시 시도해 보세요.

Logto OSS의 Management API 엔드포인트는 Cloud 버전과 다른가요?​

네. Logto Management API 식별자는 Logto Cloud와 셀프 호스팅(오픈 소스) 버전에서 다릅니다:

  • Logto Cloud: https://[tenant-id].logto.app/api

  • Logto Open Source: https://default.logto.app/api