본문으로 건너뛰기

사용자 지정 도메인

Logto 테넌트는 기본 무료 도메인 {{tenant-id}}.app.logto를 제공합니다. 그러나 auth.example.com과 같은 사용자 지정 도메인을 사용하여 사용자 경험과 브랜드 인지도를 높일 수 있습니다.

사용자 지정 도메인은 여러 기능에 사용됩니다:

노트:

서비스를 게시한 후 도메인을 변경하면 애플리케이션 코드와 통합이 여전히 이전 도메인을 참조할 수 있으므로 문제가 발생할 수 있습니다. 원활한 전환을 위해 프로덕션 테넌트 생성 시 사용자 지정 도메인을 처음부터 설정하세요.

콘솔에서 사용자 지정 도메인 구성하기​

Logto 콘솔에서 새 사용자 지정 도메인을 추가하려면 다음 단계를 따르세요:

  1. 콘솔 > 설정 > 도메인으로 이동합니다.

  2. "사용자 지정 도메인" 섹션에서 도메인 이름을 입력하고 "도메인 추가"를 클릭합니다.

    도메인 추가

  3. 표에서 CNAME 값을 복사하고, 도메인의 DNS 제공자로 이동하여 레코드를 추가합니다.

    사용자 지정 도메인 처리 중

  4. 인증 및 SSL 프로세스를 기다립니다.

    1. 사용자 지정 도메인이 추가될 때까지 10초마다 자동으로 레코드를 인증합니다. 입력한 도메인 이름이나 DNS 레코드가 정확한지 확인하세요.
    2. 인증은 일반적으로 몇 분이 걸리지만, DNS 제공자에 따라 최대 24시간이 걸릴 수 있습니다. 프로세스 중에 다른 곳으로 이동해도 괜찮습니다.

문제 해결​

SSL 인증서 문제​

사용자 지정 도메인을 설정할 때 SSL 인증서 문제가 발생하면, 이는 DNS 구성의 CAA 레코드와 관련이 있을 수 있습니다. CAA 레코드는 도메인에 대해 인증서를 발급할 수 있는 인증 기관 (CA)을 지정합니다.

CAA 레코드와 관련된 SSL 인증서 문제를 해결하려면 Cloudflare의 문서를 참조하세요.

"호스트 이름이 보류 중인 영역과 연결되어 있습니다" 오류​

사용자 지정 도메인을 추가할 때 "호스트 이름이 보류 중인 영역과 연결되어 있습니다. 소유자에게 연락하여 보류를 해제하십시오"라는 오류 메시지가 나타나면, 해당 도메인이 이미 Cloudflare 영역에 있으며 "Zone Hold" 상태로 설정되어 있음을 의미합니다. 자세한 내용은 Cloudflare 문서를 참조하세요.

이 문제를 해결하려면 영역 보류를 해제해야 합니다. Cloudflare에서 영역 보류를 해제하는 방법에 대한 지침은 위 링크를 참조하세요.

사용자 지정 도메인 사용하기​

설정을 구성한 후에는 사용자 지정 도메인 이름과 기본 Logto 도메인 이름이 테넌트에 사용할 수 있게 됩니다. 그러나 사용자 지정 도메인 이름을 활성화하려면 특정 구성이 필요합니다.

노트:

이 문서에서는 사용자 지정 도메인이 auth.example.com이라고 가정합니다.

사용자 지정 도메인 추가됨

애플리케이션의 SDK 엔드포인트 업데이트하기​

Logto SDK의 초기화 코드를 수정하여 엔드포인트의 도메인 이름을 변경하세요.

const client = new LogtoClient({
  ...,// 다른 옵션
  endpoint: 'https://auth.example.com',
});

다른 애플리케이션의 인증 엔드포인트 수정하기​

Logto SDK를 사용하지 않는 애플리케이션이 있는 경우, 해당 애플리케이션의 인증 엔드포인트를 업데이트해야 합니다.

인증 엔드포인트는 다음의 잘 알려진 URL에서 찾을 수 있습니다:

https://auth.example.com/oidc/.well-known/openid-configuration

소셜 커넥터의 콜백 URI 업데이트하기​

사용자가 사용자 지정 도메인을 사용하는 경우, 소셜 커넥터의 콜백 URI는 자동으로 업데이트됩니다. 소셜 제공자의 개발자 콘솔로 이동하여 콜백 URI를 업데이트해야 합니다.

사용자가 사용자 지정 도메인을 사용하는 경우, 소셜 커넥터의 콜백 URI는 새로운 도메인을 사용하게 됩니다. 따라서 소셜 제공자의 개발자 콘솔로 이동하여 콜백 URI를 수동으로 업데이트해야 합니다.