FAQ — 자주 묻는 질문

계정 / 로그인

어떤 이메일로 가입할 수 있나요?

도메인 제약이 없습니다. Gmail, Naver, Daum, Kakao, 회사 이메일 등 유효한 이메일 주소라면 어떤 도메인이든 가입 가능합니다.

가입 방식은 두 가지 중 하나를 선택할 수 있습니다.

• Google OAuth — Google 계정으로 원클릭 로그인
• 이메일 / 비밀번호 — 이메일과 비밀번호로 직접 가입 (비밀번호는 bcrypt로 해시 저장되며 원문은 서버에 저장되지 않습니다)

이메일 인증 메일이 오지 않아요

가입 후 수 분 내에 no_reply@cronbark.com에서 인증 메일이 발송됩니다. 받지 못한 경우 다음 순서로 확인하세요.

1. 스팸 / 프로모션 폴더 확인 — 첫 발송은 스팸으로 분류되기 쉽습니다.
2. 로그인 페이지의 “인증 메일 재발송” 버튼으로 다시 요청 (이전 인증 토큰은 무효화되고 새 토큰이 발급됩니다).
3. 그래도 오지 않으면 cronbark.contact@gmail.com 으로 가입 이메일과 함께 문의해 주세요.

비밀번호를 잊어버렸어요

로그인 페이지의 “비밀번호를 잊으셨나요?” 링크 또는 /forgot-password 로 이동하세요.

1. 가입한 이메일 주소를 입력
2. 수신한 재설정 메일의 링크를 클릭 (1시간 이내 유효)
3. 새 비밀번호 입력 (8자 이상, 영문 + 숫자 + 특수문자 포함)

보안상 이메일이 존재하는지 여부는 응답에서 구분되지 않습니다 — 등록되지 않은 이메일을 입력해도 동일한 성공 메시지가 표시됩니다.

비밀번호를 변경할 수 있나요?

• 이메일 / 비밀번호 가입자: 로그인 후 /settings 의 보안 섹션에서 현재 비밀번호 확인 후 새 비밀번호로 변경할 수 있습니다. 변경 즉시 모든 기기에서 로그아웃되며, 재로그인이 필요합니다.
• 보안 강화를 위해 마지막 변경 후 90일이 지나면 로그인 직후 비밀번호 변경 안내 팝업이 표시됩니다 (강제는 아니며 “다음에 변경”을 선택하면 7일 뒤에 다시 안내됩니다).
• Google 로그인 사용자: CronBark에 별도 비밀번호가 없습니다. 비밀번호 관리는 연결된 Google 계정에서 직접 수행해 주세요.

Google 계정과 이메일 비번 계정을 같이 쓸 수 있나요?

불가합니다. 하나의 이메일 주소당 하나의 인증 방식만 사용할 수 있으며, 최초 가입 시 선택한 방식이 계속 적용됩니다. Google 계정 소유자는 Google OAuth 사용을 권장합니다 — 원클릭 로그인이 가능하고 비밀번호 관리가 불필요합니다.

• user@gmail.com으로 Google OAuth 가입 → 이후 해당 이메일 + 비밀번호로는 로그인 불가
• user@naver.com으로 이메일/비번 가입 → Google OAuth 로그인 불가 (Naver는 Google 계정이 아니지만, Gmail이어도 마찬가지)

비밀번호로 가입한 이메일로 Google OAuth 로그인을 시도하면 "이 이메일은 비밀번호 방식으로 가입되어 있습니다. /login 페이지에서 비밀번호로 로그인해 주세요." 메시지와 함께 에러가 반환됩니다. 두 방식을 동시에 쓰고 싶다면 별도 이메일 주소로 각각 가입해야 하며, 워크스페이스 멤버십은 이메일별로 관리됩니다.

초대 링크를 받았는데 어떻게 가입하나요?

팀원의 초대 메일에 포함된 링크(https://app.cronbark.com/invite/{token})를 클릭하면 초대 수락 페이지로 이동합니다. 여기서 두 가지 방식을 동등하게 선택할 수 있습니다.

1. Google 계정으로 합류 — Google OAuth로 원클릭 합류 (Gmail / Google Workspace 사용자 권장)
2. 비밀번호로 가입하며 합류 — 이메일 비밀번호를 설정하고 바로 합류 (별도 이메일 인증 불필요)

⚠️ 어떤 방식이든 초대받은 이메일 주소와 동일한 계정이어야 합니다. 다른 이메일로는 합류할 수 없습니다 (보안 정책).

이미 CronBark 계정이 있는 경우, 페이지 하단의 “기존 계정으로 로그인하기” 링크를 눌러 로그인하면 초대가 자동 수락됩니다. 초대 링크는 발송 후 7일간 유효하며, 만료 시 Owner/Admin에게 재발송을 요청하세요.

일반

토큰을 잃어버렸어요

Cronjob 상세 페이지의 API Token 섹션에서 언제든 재확인할 수 있습니다. 보안 우려가 있으면 기존 토큰을 삭제한 뒤 새 토큰을 발급하세요 — 삭제된 토큰은 즉시 무효화됩니다.

Ping이 왔는데 대시보드에 안 보여요

다음 순서로 확인하세요:

1. 토큰이 정확한지 (복사 시 공백 포함 여부)
2. URL 스킴 — HTTPS (https://)인지
3. 대시보드가 Status = All 필터로 보고 있는지
4. Cronjob이 삭제되지 않았는지

”지연”과 “타임아웃”의 차이가 뭔가요

• 지연: “예상보다 오래 걸리는 중” — 아직 성공/실패 보고를 받지 않음, 상태 계속 갱신.
• 타임아웃: “이 Execution은 죽은 걸로 간주” — 이후 도착하는 success/fail은 새 Execution으로 처리.

자세한 내용은 상태 판정 로직 참고.

Cronjob 등록 시 입력하는 cron 표현식은 무슨 역할인가요

표시·UI 보조용 메타데이터입니다. CronBark 는 push 기반(여러분의 배치 스크립트가 ping 을 쏴줘야 동작 감지)이라, 등록한 cron 식 시간에 맞춰 CronBark 가 알아서 뭔가 검사하지는 않습니다.

cron 표현식은 다음 용도로 쓰입니다.

• 대시보드/상세 페이지에 “이 잡은 매시 0분에 돈다” 같은 스케줄 정보 표시
• “다음 실행 예상 시각” 계산해서 안내 (예: “다음 실행 4분 후”)
• 알림 메일·실패 리포트에 스케줄 정보 포함

실제 알림 트리거는 cron 표현식이 아니라 별도로 입력하는 분 단위 임계값으로 결정됩니다.

• start ping 수신 후 지연 임계값(기본 10분) 안에 success/fail 안 오면 → “지연” 알림
• 타임아웃 값(기본 60분) 넘기면 → “타임아웃” 알림 (해당 Execution 죽은 걸로 처리)
• fail ping 받으면 즉시 “실패” 알림

따라서 실제 배치 스케줄과 cron 식이 살짝 달라도 알림 동작에는 지장이 없지만, “다음 실행 예상” 안내가 실제와 어긋나게 표시되므로 가능하면 실제 스케줄에 맞춰 입력하시는 것을 권장합니다.

한 Cronjob에 여러 알림 채널을 걸 수 있나요

네. Slack · 이메일 여러 채널을 동시에 연결할 수 있고, 조건(실패 즉시 / 지연 / 타임아웃 / 복구)도 각각 다르게 설정 가능합니다.

오프라인 환경에서도 쓸 수 있나요

현재는 SaaS만 제공됩니다. 자체 호스팅(Self-hosted) 버전은 cronbark.contact@gmail.com 으로 문의 주세요.

Python 3.8 이하에서 SDK 쓸 수 있나요

SDK는 Python 3.9+만 지원합니다. 3.8 이하 환경에서는 Ping 엔드포인트를 requests 등으로 직접 호출하세요 — 이 방식은 Python 버전 제약이 없습니다.

가격 / 결제

1. 플랜별 차이는 어떻게 되나요?

🎁 베타 기간 안내 — 현재는 베타 기간으로 결제 시스템(Stripe)이 아직 연동되지 않았습니다. 신규 가입 시 Business 플랜이 자동 부여되며, 정식 출시 전까지 모든 기능을 무료로 사용할 수 있습니다. 아래 표는 정식 출시 후 적용될 가격입니다.

원화 금액은 참고용 예상 환산값입니다. 실제 청구는 결제 시점의 환율에 따라 산정되며, 국내 사업자용 원화 결제·세금계산서는 Team 플랜 이상부터 지원될 예정입니다.

Enterprise 도입은 cronbark.contact@gmail.com 으로 문의 주세요.

2. 결제 수단은 무엇이 지원되나요?

베타 기간 동안 결제는 진행되지 않습니다. 아래는 정식 출시 시 적용될 결제 정책입니다.

• 신용카드 — Visa, Mastercard, AMEX (국내/해외 모두)
• 세금계산서 — Team 플랜부터 발행 가능
• 연간 결제 선택 시 10% 할인

3. 플랜 변경이 가능한가요?

• 업그레이드: 즉시 반영, 일할 계산 차액 청구
• 다운그레이드: 다음 결제 주기부터 적용
  • 이력 보관 기간 축소는 다운그레이드 후 적용되며, 초과 데이터는 다음 정기 cleanup에서 삭제됩니다.

4. 환불 정책은 어떻게 되나요?

• 결제 후 7일 이내 미사용: 전액 환불
• 7일 이후: 사용 일수 일할 계산 환불
• Enterprise: 별도 계약 조건

자세한 약관은 이용약관을 참고하세요.

5. 베타 기간에도 결제가 필요한가요?

• 베타 기간 동안에는 모든 기능을 무료로 사용할 수 있습니다.
• 신규 가입 시 Business 플랜이 자동 부여됩니다. 정식 결제가 시작되더라도 베타 기간 중에 등록한 데이터는 그대로 보존되며, 한도를 초과한 워크스페이스가 다운그레이드되더라도 신규 등록만 차단되고 기존 크론잡은 계속 동작합니다(그랜드파더링).
• 정식 출시 일정 및 결제 시작 시점은 cronbark.contact@gmail.com 또는 대시보드 공지로 사전 안내됩니다.

데이터 정책

1. 실행 이력은 얼마나 보관되나요?

플랜별 보관 기간:

보관 기간이 경과한 레코드는 매일 새벽 03:00 KST에 자동 정리됩니다. 실패 로그도 동일 기간 보관되며, 건당 최대 20MB입니다.

플랜 변경 시 적용 시점

• 업그레이드: 새로운(더 긴) 보관 기간은 다음 정리 사이클(매일 새벽 03:00 KST)부터 자동 적용됩니다. 단, 이미 삭제된 데이터는 복원할 수 없습니다.
• 다운그레이드: 더 짧은 보관 기간을 초과하는 기존 데이터는 다음 정리 사이클에서 삭제됩니다. 다운그레이드 전 중요한 실행 이력이 있다면 데이터 내보내기 후 진행하실 것을 권장합니다.

2. 실행 이력을 내보낼 수 있나요?

• 네. 실행 이력 페이지의 “내보내기” 버튼으로 현재 필터 조건에 맞는 데이터를 CSV 파일로 다운로드할 수 있습니다 (BOM+UTF-8, 엑셀에서 한글 깨짐 없이 열립니다).
• API 로 직접 받으려면 GET /api/v1/executions/export/csv 엔드포인트를 사용하세요. 자세한 파라미터는 REST API 레퍼런스를 참고하세요.
• JSON export 는 향후 로드맵에 포함되어 있습니다.

3. 회원 탈퇴 시 데이터는 어떻게 처리되나요?

회원 탈퇴는 이메일 인증 코드 검증 후 즉시 영구 삭제(hard delete) 됩니다. soft-delete 나 grace period 가 없으므로, 보관이 필요한 데이터는 탈퇴 전에 먼저 내보내 두세요.

탈퇴 시 처리되는 내역

• 본인 계정 정보 — 이메일, 프로필, 인증 정보 모두 파기.
• 다른 조직의 멤버십 — 자동으로 탈퇴 처리. 해당 조직의 다른 멤버 데이터에는 영향 없음.
• 본인이 발급한 API 토큰 — 모두 폐기. 사용 중인 토큰은 즉시 ping 이 차단되므로, 탈퇴 전에 다른 팀원이 재발급하도록 인계하세요.

탈퇴가 차단되는 경우 — 다음 조건이 남아 있으면 데이터 동반 손실 방지를 위해 탈퇴가 거부됩니다.

• 본인 외 다른 멤버가 있는 Owner 워크스페이스가 남아 있을 때 → 먼저 다른 멤버에게 Owner 권한을 이전한 뒤 탈퇴.
• 본인이 Owner 인 삭제된(soft-deleted) 워크스페이스의 복원 기간이 아직 남아 있을 때 → 복원해서 정리하거나, grace period 만료를 기다린 뒤 탈퇴.

법정 보존 의무 데이터는 위와 별개로 정해진 기간만큼 보관 후 파기됩니다.

• 결제 기록: 5년
• 접속 로그: 3개월

자세한 내용은 개인정보처리방침을 참고하세요.

4. 실행 로그의 최대 크기는?

• 실행당 최대 20MB까지 저장됩니다.
• 초과 시 앞부분만 저장되고 뒷부분은 잘립니다.
• 잘림 방지를 위해 로그 본문은 요약 후 전송하는 것을 권장합니다 (예: tail 500줄).

5. 조직을 삭제했는데 복구할 수 있나요?

네, 플랜별 복원 가능 기간(grace period) 이내라면 전체 복구가 가능합니다.

• 내부적으로 워크스페이스 삭제는 Soft Delete로 처리되어, 삭제 시점에 모든 Cronjob · 알림 규칙 · API 토큰 · 멤버 관계가 그대로 보존됩니다.
• 복원이 필요하면 대시보드에 다시 로그인했을 때 자동으로 안내되는 복원 페이지에서 직접 복원하거나, cronbark.contact@gmail.com 으로 삭제된 워크스페이스 이름과 삭제 시각을 알려주세요.
• grace period 가 경과하면 하위 리소스까지 자동으로 영구 삭제되며 이 시점부터는 복구가 불가능합니다.

6. 조직을 탈퇴할 수 있나요?

역할에 따라 다릅니다.

• Admin / Member / Viewer: 조직 설정 → 위험 영역 → 조직 탈퇴 버튼으로 언제든 스스로 탈퇴할 수 있습니다. 재합류하려면 Owner의 초대가 다시 필요합니다.
• Owner: 탈퇴할 수 없습니다. 대안은 두 가지입니다.
  1. 다른 Admin 에게 소유권 이전 (조직 설정 → 멤버 → 해당 멤버 행의 ⋯ 메뉴 → 소유권 이전) 후 Admin 역할로 돌아가 탈퇴.
  2. 워크스페이스 자체를 삭제 (플랜별 grace period 적용 — 위 5번 항목 참고).

보안

1. Rate Limit은 어떻게 되나요?

• 초과 시 HTTP 429 Too Many Requests 응답
• 시간당/일별 누적 제한은 없습니다
• 429 수신 시 지수 백오프 권장 (예: 1초 → 2초 → 5초)

# 429 응답 예시
HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json
 
{
  "detail": "rate limit exceeded",
  "limit": 5,
  "window": "1s"
}

권장 재시도 로직 (의사코드):

# 지수 백오프 예시
for attempt in range(5):
    resp = requests.post(url)
    if resp.status_code != 429:
        break
    time.sleep(2 ** attempt)  # 1s, 2s, 4s, 8s, 16s

2. API 토큰을 회전(rotate)할 수 있나요?

• 네. 대시보드에서 버튼 한 번으로 회전할 수 있습니다.
  • 크론잡 상세 → 토큰/연동 또는 API 토큰 페이지에서 토큰의 회전 버튼을 누르면, 새 토큰이 발급되고 기존 토큰은 즉시 무효화됩니다.
  • 새 토큰은 발급 직후 한 번만 표시되니 안전한 곳에 보관하세요.
  • 회전 후 실행 중인 크론잡의 환경변수/시크릿을 새 토큰으로 업데이트해야 합니다.
• 회전은 내부적으로 “새 토큰 발급 + 기존 토큰 삭제” 로 처리됩니다. REST 로 직접 할 때도 동일하게 새 토큰을 발급한 뒤 기존 토큰을 삭제하면 됩니다(별도 회전 전용 엔드포인트는 없음).
• 예약·자동 회전(주기적 자동 교체) 기능은 향후 지원 예정입니다.

3. SSO(SAML)는 언제 지원되나요?

• Enterprise 플랜 전용 기능으로, 현재 정식 지원은 진행 중입니다. 도입을 검토하신다면 사용 중인 Identity Provider 와 함께 일정/요건을 협의해 드립니다.
• SAML 2.0 호환 IdP(Okta · Azure AD/Entra ID · Google Workspace · OneLogin 등)를 대상으로 합니다.
• 문의: cronbark.contact@gmail.com

4. 데이터 암호화는 어떻게 되나요?

플랜 한도

1. 플랜별 크론잡 수 한도를 초과하면?

• 한도 도달 시 신규 크론잡 등록이 차단됩니다.
• 기존 크론잡은 계속 동작합니다 (알림/수집 유지).
• 플랜 업그레이드 시 즉시 해제됩니다.

2. 팀 멤버 수 한도는?

• 한도 도달 시 신규 초대가 차단됩니다.
• 멤버 제거 시 즉시 슬롯이 반환됩니다.
• 역할(role)은 owner / admin / member / viewer 4단계입니다.

2-1. 팀원 초대는 어떻게 취소/재발송하나요?

• 대시보드의 조직 설정 → 대기 중인 초대 섹션에서 각 초대 옆의 재발송 / 취소 버튼으로 관리합니다.
• 재발송: 새 토큰이 발급되고 기존 토큰은 즉시 무효화됩니다. 만료 시각도 7일 뒤로 재설정됩니다.
• 취소: 초대 상태가 cancelled로 바뀌어 해당 링크로는 더 이상 합류할 수 없습니다.
• 모든 조작은 감사 로그(invite_resent, invite_cancelled)에 기록됩니다.
• 관리는 Owner / Admin만 가능합니다.

2-2. 감사 로그는 어떻게 사용하나요?

활성화 조건

• Business 플랜 이상에서 조회 가능 (/org-settings → 감사 로그 섹션)
• Owner / Admin 역할만 조회할 수 있습니다

기록 항목

• 멤버 변경: 역할 변경, 멤버 제거, 탈퇴
• 초대: 발송, 재발송, 취소, 만료, 수락
• 조직 설정: 워크스페이스 생성/이름 변경/삭제, 플랜 변경
• 보안: 비밀번호 변경

중요 — 기록 vs 조회 분리

• 기록 자체는 모든 플랜에서 수집됩니다. Free/Team 플랜에서도 이벤트는 누락 없이 저장됩니다.
• 조회만 Business 이상으로 제한됩니다. 따라서 Business로 업그레이드하는 순간 과거 기록까지 즉시 조회할 수 있어요.
• 컴플라이언스/지원 목적의 운영자 조회는 플랜과 무관하게 항상 가능합니다.

3. 크론잡 그룹은 몇 개까지 만들 수 있나요?

• 모든 플랜에서 무제한 — Free, Team, Business, Enterprise 구분 없이 자유롭게 그룹을 생성할 수 있습니다.
• 그룹은 조직화 도구이므로 한도로 제한하지 않습니다.
• 그룹별 알림 규칙(동일 그룹의 모든 크론잡에 일괄 적용)도 제한 없이 설정 가능합니다.

자세한 사용법은 크론잡 그룹 가이드를 참고하세요.

4. 워크스페이스를 여러 개 만들 수 있나요?

• 한 계정이 여러 워크스페이스에 멤버로 동시 소속할 수 있습니다 — 다른 조직에서 보낸 초대를 수락하면 됩니다.
• 다만 현재 대시보드는 단일 활성 워크스페이스 컨텍스트로 동작합니다. 여러 조직을 한 계정에서 자유롭게 전환할 수 있는 워크스페이스 스위처 UI 는 향후 로드맵에 포함되어 있습니다.
• Enterprise 도입 시 별도 협의가 가능합니다 — cronbark.contact@gmail.com.

5. API 토큰 수 제한이 있나요?

• 크론잡당 제한 없음 — 환경/서버별로 분리 발급을 권장합니다 (dev / staging / prod).
• 워크스페이스 전체에 대한 제한도 없습니다.
• Business 이상에서는 Audit log로 토큰 사용 이력을 추적할 수 있습니다.

토큰 네이밍 컨벤션 예시:

prod-web-nightly-backup
staging-etl-hourly
dev-local-test

이렇게 환경/서버/용도를 토큰 이름에 포함하면 감사 및 회전 시 관리가 쉽습니다.

더 궁금한 점이 있으면

cronbark.contact@gmail.com 으로 메일 주세요. 24시간 안에 답변드립니다.