핵심 기능

커스텀 도메인

Workspace의 CMS를 cms.onttle.com 같은 고객 도메인으로 접속하게 하는 방법, DNS 설정과 검증, 커스텀 도메인에서의 로그인 동작을 설명합니다.

커스텀 도메인을 연결하면 Workspace의 CMS를 app.onttle.com 대신 고객이나 팀의 도메인(예: cms.onttle.com)으로 접속할 수 있습니다. 에이전시가 고객에게 CMS를 넘기거나, 사내 서비스를 자사 도메인으로 운영할 때 사용합니다. 연결된 도메인에는 커스텀 테마가 함께 적용되어 로고와 색상까지 바꿀 수 있습니다.

항목 내용
요금제 Pro 이상 (Free에서는 메뉴가 비활성화되고 업그레이드 안내가 표시됩니다)
권한 소유자(OWNER) 또는 관리자(ADMIN)
개수 Workspace당 최대 20개
형식 서브도메인만 가능 (cms.onttle.com ✓, acme.com ✗)

도메인 추가

  1. Workspace → 도메인으로 이동합니다.
  2. 연결할 호스트명을 입력하고 추가를 누릅니다. 입력값은 소문자로 정리되며 https://나 경로는 넣지 않습니다.
  3. 안내된 DNS 레코드를 도메인 관리 업체(가비아, Cloudflare, Route 53 등)에 등록합니다.
  4. DNS가 반영되면 Onttle이 자동으로 검증하고 상태가 활성으로 바뀝니다. 바로 확인하려면 DNS 설정 후 확인을 누릅니다.

DNS 레코드

타입 이름 값 비고
CNAME cms.onttle.com 화면에 표시된 값 항상 필요합니다.
TXT _vercel.acme.com 형식 화면에 표시된 값 도메인 소유권 확인이 필요한 경우에만 표시됩니다.
  • 값은 각 행의 복사 버튼으로 그대로 복사할 수 있습니다. 값 끝에 점(.)을 붙일 필요는 없습니다.
  • 같은 이름의 A 레코드나 다른 CNAME이 이미 있다면 삭제해야 합니다. CNAME은 같은 이름에 다른 레코드와 함께 둘 수 없습니다.
  • Cloudflare를 쓴다면 해당 레코드의 프록시(주황색 구름)를 끄고 DNS only로 둡니다.

검증 주기

도메인을 추가하면 1분, 5분, 15분, 1시간 뒤에 확인하고, 그 뒤로는 6시간마다 최대 72시간 동안 다시 확인합니다. 활성화된 도메인도 매일 한 번 점검합니다. DNS 전파에는 보통 몇 분에서 길면 48시간이 걸립니다.


상태

상태 의미
DNS 설정 대기 레코드가 아직 반영되지 않았거나 등록되지 않았습니다. 안내된 레코드를 확인하세요.
활성 검증이 끝나 도메인으로 접속할 수 있습니다. HTTPS 인증서는 자동으로 발급됩니다.
오류 72시간 안에 검증되지 않았거나 확인 중 문제가 생겼습니다. 레코드를 고친 뒤 DNS 설정 후 확인을 누르면 다시 검증합니다.

상태 아래에 표시되는 안내 문구는 다음 원인을 뜻합니다.

안내 원인과 조치
CNAME 레코드가 아직 Onttle을 가리키지 않습니다 CNAME이 없거나 값이 다릅니다. 안내된 값으로 등록하고 잠시 뒤 다시 확인하세요.
TXT 레코드가 없습니다 / 값이 다릅니다 소유권 확인용 TXT 레코드를 안내된 이름과 값으로 등록하세요.
DNS 설정이 올바르지 않습니다 같은 이름에 충돌하는 레코드가 있는지 확인하세요.
72시간 안에 검증되지 않았습니다 레코드를 확인한 뒤 DNS 설정 후 확인으로 다시 시작합니다.
도메인 연결 서비스에 문제가 있습니다 잠시 뒤 다시 시도하고, 계속되면 지원에 문의하세요.

대표 도메인

도메인이 여러 개면 하나를 대표로 지정할 수 있습니다. 처음 추가한 도메인이 자동으로 대표가 되며, 활성 상태인 도메인만 대표로 바꿀 수 있습니다.


커스텀 도메인에서의 동작

  • 커스텀 도메인은 그 Workspace 전용입니다. Workspace 목록, 새 Workspace 만들기, 다른 Workspace 화면은 열리지 않고 해당 Workspace로 이동합니다.
  • 해당 Workspace의 멤버가 아닌 계정으로 로그인하면 접근할 수 없다는 화면이 표시됩니다.
  • 로그인 화면과 상단 바에는 Workspace의 커스텀 테마(로고, 색상, 제목)가 적용됩니다.

로그인

  • 이메일 로그인은 커스텀 도메인에서 그대로 진행됩니다.
  • Google, GitHub 로그인은 인증을 위해 잠시 app.onttle.com을 거쳤다가 커스텀 도메인으로 돌아옵니다. 돌아온 뒤 자동으로 로그인됩니다. 이 과정은 1분 안에 끝나야 하며, 지나면 로그인 화면에서 다시 시도하라는 안내가 표시됩니다.
  • 로그인 세션은 도메인마다 별개입니다. app.onttle.com에 로그인했어도 커스텀 도메인에서는 다시 로그인해야 합니다.
  • 비밀번호 재설정, 가입 확인 등 이메일의 링크는 app.onttle.com에서 열립니다. 처리 후 커스텀 도메인에서 로그인하면 됩니다.

도메인 삭제

삭제를 누르면 그 도메인으로는 즉시 접속할 수 없습니다. 삭제한 호스트명은 30일 동안 다른 Workspace에서 사용할 수 없고, 같은 Workspace에서는 바로 다시 추가할 수 있습니다.


추가할 수 없는 호스트명

입력 결과
acme.com (루트 도메인) 서브도메인만 연결할 수 있습니다. cms.onttle.com처럼 입력하세요.
onttle.com의 하위 도메인, localhost, 호스팅 업체 기본 도메인 예약된 호스트명이라 사용할 수 없습니다.
IP 주소, 포트가 포함된 주소 올바른 호스트명이 아닙니다.
다른 Workspace에 연결된 호스트명 이미 사용 중인 호스트명입니다. 30일 전에 삭제된 호스트명도 포함됩니다.
21번째 도메인 Workspace당 20개까지 연결할 수 있습니다. 사용하지 않는 도메인을 삭제하세요.