01.software 문서

워크스페이스 운영

워크스페이스 식별 정보, 역할, 기능 활성화, 운영 책임을 관리합니다.

팀 접근이나 소유권을 바꾸거나, 기능 활성화를 조정하거나, 고객 계정을 지원할 때 이 페이지를 사용합니다. 처음 설정과 역할 표는 워크스페이스 설정에서 시작합니다.

운영 모델

워크스페이스는 콘텐츠, 커머스, 커뮤니티, 이벤트, 연동을 나누는 경계입니다. 워크스페이스 변경은 반드시 담당자와 출시 또는 지원 목적에 연결합니다.

영역확인할 담당자변경 전 점검
식별 정보워크스페이스 소유자워크스페이스 이름, 슬러그, 도메인, 지원 연락처
역할tenant-admin모든 사용자에게 최소 권한 적용
기능제품 또는 운영 담당자플랜 허용 범위와 준비 상태 차단 요소
자격 증명기술 담당자키 로테이션, CORS, 웹훅 수신자
결제재무 또는 소유자활성 구독과 결제 상태

워크스페이스 레코드를 변경하기 전에 대상 워크스페이스를 선택하세요. super-admin도 수정하거나 삭제하기 전에 워크스페이스를 선택해야 하며, 선택하지 않으면 거부됩니다.

설정 편집 화면에서 워크스페이스 선택 안내가 나오면 왼쪽 메뉴를 열어 작업할 워크스페이스를 선택하세요. 읽기 화면에서는 표시된 워크스페이스 이름을 확인하세요. 환경을 사용할 수 없으면 본문의 환경 선택 메뉴 열기 버튼으로 메뉴를 열어 준비된 환경을 선택하세요.

변경 흐름

워크스페이스 레코드 확인

운영하려는 워크스페이스와 레코드의 이름, 슬러그, 소유권 메타데이터가 일치하는지 확인합니다.

역할 배정 검토

운영자마다 접근 역할에서 필요한 최소 권한의 역할을 배정합니다. 다른 워크스페이스의 멤버십으로 대신할 수 없으므로 해당 워크스페이스의 배정을 확인합니다.

기능과 플랜 정렬

현재 플랜에서 허용하는 기능만 활성화하고, 활성화한 기능마다 운영 담당자를 지정합니다.

준비 상태 재점검

접근, 기능, 자격 증명, 결제 상태를 바꾼 뒤에는 출시 준비 상태로 간주하기 전에 준비 상태 점검을 다시 실행합니다.

팀원 초대

Live 워크스페이스의 tenant-admin과 super-admin은 콘솔의 설정 → 프로젝트 → 프로젝트 팀 → 팀원 초대에서 초대할 수 있습니다.

  1. 이메일을 입력하고 Live와 Sandbox 역할을 하나씩 고릅니다. 기본값은 두 워크스페이스 모두 워크스페이스 뷰어입니다. 워크스페이스마다 역할을 바꾸거나 한쪽을 접근 없음으로 둘 수 있습니다. Sandbox가 없으면 Live 역할만 고릅니다.
  2. 팀원 초대를 누릅니다. 저장된 초대는 대기 중인 초대에 워크스페이스별 역할과 만료 시점으로 표시됩니다.
  3. 받은 사람은 이메일의 링크를 열고, 초대받은 이메일과 같은 주소의 계정으로 로그인하거나 가입한 뒤 직접 수락합니다. 이메일과 비밀번호로 새로 가입하면 먼저 가입 인증 메일의 링크로 인증합니다.

이미 인증된 계정은 유효한 초대 링크로 별도 인증 메일 없이 수락할 수 있습니다. 초대 메일을 받은 이메일 주소로 로그인하세요. 2단계 인증이 필요하면 먼저 완료하세요.

초대는 7일 뒤 만료됩니다. 초대 취소를 누르면 해당 링크로 수락할 수 없습니다. 같은 이메일로 다시 초대하면 역할과 만료 시점이 갱신되고 이전 링크는 만료됩니다. 이메일을 보내지 못했다는 안내가 나오면 같은 이메일로 다시 초대하세요.

대기 중인 초대는 프로젝트당 최대 20개입니다. 요청이 많다는 안내가 나오면 잠시 후 다시 시도하세요. 이미 프로젝트 멤버인 사람의 역할은 멤버 목록에서 확인합니다.

멤버십과 소유권 변경

Live의 tenant-admin이 Sandbox를 생성하거나 초기화하면 실행자와 소유자에게 새 Sandbox의 tenant-admin 역할이 부여됩니다. 초기화는 직전 Sandbox 멤버의 역할도 이어받으며, 실행자는 기존 역할과 관리자 역할을 함께 받습니다. Live에만 있는 다른 멤버는 자동으로 추가되지 않습니다. 새 멤버 구성이 Sandbox 인원 상한을 넘거나 처리에 실패하면 초기화 전체가 취소되고 이전 Sandbox가 유지됩니다. super-admin은 실행했다는 이유만으로 별도 멤버십을 받지 않습니다. 인원 상한으로 초기화가 거절되면 프로젝트 팀 패널에서 기존 Sandbox의 불필요한 멤버를 줄인 뒤 다시 초기화하세요.

tenant-admin은 해당 역할을 가진 워크스페이스의 멤버십만 관리합니다. 쓰기 전에 대상 활성 워크스페이스를 선택하고, 선택이 없거나 오래됐거나 권한이 없으면 바로잡은 뒤 재시도합니다. tenant-editor와 tenant-viewer는 자신에게 관리자 접근을 부여할 수 없습니다.

소유권은 현재 워크스페이스 소유자 또는 super-admin만 이전할 수 있습니다. 받을 사람은 이미 해당 워크스페이스의 멤버여야 하며, 이전이 완료되면 기존 역할을 유지하면서 tenant-admin도 부여됩니다. 소유권 메타데이터를 직접 수정하는 대신 소유권 이전 기능을 사용합니다. 워크스페이스를 소유한 운영자를 제거하기 전에는 소유권을 먼저 이전합니다.

아래 고객 지원 작업은 Console 운영자 멤버십과 별개인 고객 계정에 적용됩니다. 앱의 로그인과 본인 확인 구현은 Customers 작업 가이드를 사용합니다.

기능 가드레일

플랜별 기능 가용성은 기능 계획 페이지에서 관리합니다. 현재 플랜이 허용하는 기능만 활성화하세요.

지원, 모더레이션, 자격 증명 담당자가 정해지기 전에는 고객 대상 기능을 활성화하지 마세요.

고객 수동 등록

고객 목록의 고객 등록 버튼으로 이름(필수), 이메일과 전화번호(선택)만으로 고객 기록을 만들 수 있습니다. 선택한 워크스페이스의 관리자와 super-admin만 등록할 수 있습니다. 등록 창을 연 뒤 다른 탭 등에서 활성 워크스페이스가 바뀌면 등록이 거부되므로, 현재 워크스페이스를 확인하고 화면을 새로고침한 뒤 다시 등록하세요.

등록한 고객에게는 비밀번호가 없습니다. 고객이 같은 이메일로 인증코드 로그인이나 소셜 로그인을 하면 이 기록으로 로그인하고, 기존 주문과 정보가 그대로 이어집니다. 이메일을 잘못 입력하면 그 주소의 주인이 이 기록에 접근할 수 있으니 정확히 확인하세요. 이미 같은 이메일의 고객이 있으면 등록되지 않습니다.

등록 결과를 확인할 수 없다는 안내가 나오면 고객 목록이 새로 조회됩니다. 다시 등록하기 전에 입력한 이름으로 고객이 이미 등록됐는지 확인하세요.

고객 정지

고객 편집 화면의 계정/보안 탭에서 현재 정지 상태를 확인할 수 있습니다. super-admin은 문서 컨트롤의 계정 정지 또는 정지 해제 버튼으로 상태를 변경할 수 있습니다. 고객 정보를 저장하는 것만으로는 정지 상태가 바뀌지 않습니다.

고객 정지 해제는 세션 폐기가 완료된 뒤에만 수행할 수 있습니다. 정지 해제가 409로 거부되면 처리 완료 후 다시 시도하세요. 계속되면 지원팀에 문의하세요.

고객 동의

직접 고객 가입에서는 워크스페이스가 필수 약관 동의를 수집하고 증빙을 보관합니다. 고객의 acceptsTos와 tosVersion은 워크스페이스의 자기 신고 값입니다.

Hosted 가입·재동의에서 서버가 기록한 약관 동의 이력은 Admin Panel의 고객 → 고객 상세 → 개인정보/동의에서 확인합니다. 고객 기능이 활성화된 워크스페이스를 선택한 뒤, 읽기 권한이 있는 tenant-admin 또는 super-admin이 해당 고객으로 필터된 목록을 열 수 있습니다. 이 이력과 직접 가입 시 보관하는 증빙은 별도로 관리합니다.

Hosted 필수 동의는 기본적으로 꺼져 있습니다. 요청 시 플랫폼 운영자가 활성화하므로 지원팀에 문의하세요. 활성화 전에 현재 이용약관·개인정보 처리방침 버전과 활성 OAuth 클라이언트의 유효한 이용약관 링크가 구성되어 있어야 합니다.

활성화하면 Hosted 비밀번호·이메일 코드·소셜 로그인은 인가 코드 발급 전에 고객의 최신 영수증과 워크스페이스의 현재 문서 버전을 비교합니다. 영수증이 없거나 버전이 다르면 현재 문서에 다시 동의해야 하며, 승인하면 새 영수증을 추가합니다. Direct 로그인과 이미 발급된 세션의 refresh는 이 게이트의 대상이 아닙니다. 설정이 꺼진 워크스페이스의 기존 로그인 동작은 유지됩니다.

개인정보 처리방침 작성

01 SOFTWARE로 사이트를 운영하면 회원·주문자 개인정보의 처리를 01 SOFTWARE에 위탁하게 됩니다. 사이트의 개인정보 처리방침에 다음을 적으세요. 아래 내용은 작성 안내이며 법률 자문이 아닙니다.

  • 수탁자: 영원(01 SOFTWARE). 위탁업무는 사이트 시스템 운영과 데이터 보관입니다.
  • 재위탁과 국외 이전: 01 SOFTWARE 개인정보처리방침 제6조에서 사이트가 쓰는 기능에 해당하는 업체를 옮겨 적고 링크를 겁니다. 동영상·AI 기능을 쓰지 않으면 해당 업체는 빼도 됩니다.
  • 거부 방법과 효과: 회원·주문자가 사이트에 국외 이전 거부를 요청하는 방법과, 거부했을 때 제한되는 서비스를 적습니다. 01 SOFTWARE는 사이트의 지시에 따라 처리합니다.
  • 결제대행사: 토스페이먼츠·포트원 등 사이트가 직접 계약한 결제대행사는 사이트가 직접 적습니다.
  • 탈퇴와 파기: 셀프 탈퇴 시 계정 개인정보를 파기하는 범위와 시점은 고객 셀프 탈퇴를 참고합니다.

고객 셀프 탈퇴

로컬 비밀번호가 있는 고객은 SDK에서 재인증 후 자기 계정을 즉시 보관할 수 있습니다. mode 없는 기존 호출은 incomplete, trialing, active, past_due 멤버십이 있으면 탈퇴를 거부하며, 해지 예약 중에도 활성 상태가 끝나기 전까지는 거부합니다. API가 멤버십을 자동 해지하지는 않습니다. 소셜 전용 계정 등 로컬 비밀번호가 없는 고객은 저장된 이메일로 받은 탈퇴 전용 일회성 코드로 확인할 수 있습니다. 코드는 같은 refresh-token family 세션에 묶여 refresh 후에도 유효하고 10분 뒤 만료되며 새 약관 동의나 로그인 세션 발급은 필요하지 않습니다.

명시적인 now·scheduled 모드는 예약 수명주기를 사용합니다. 갱신을 막고, 예약에서는 고정된 종료 시각까지 기존 이용권을 유지하며, 계정 보관 전에 이용권을 종료합니다. 재인증한 예약 취소도 갱신을 재개하지 않습니다. SDK의 탈퇴 결과와 영수증 흐름을 참고하세요.

계정에 탈퇴 시각과 구조적 감사 기록을 남기고 기존 보관의 세션 폐기를 적용합니다. 탈퇴에는 복구 유예 기간이 없습니다. 탈퇴가 기록되면 바로 계정 개인정보(이름, 이메일, 전화번호, 저장된 주소, 프로필 등 계정 데이터)를 운영자 파기 작업과 같은 범위로 파기합니다. 파기가 실패해도 탈퇴는 유지되며, 자동 재시도로 120시간 안에 파기를 마칩니다.

주문·결제·멤버십 청구 내역은 주문에 기록된 고객 정보를 포함해 유지합니다. 이 기록의 보존 기간은 따로 정하며 이번 파기 범위에 포함되지 않습니다.

탈퇴한 계정은 파기를 기다리는 동안에도 복원할 수 없습니다(409). 파기가 끝나면 이메일이 해제되어 같은 이메일로 다시 가입할 수 있습니다. 새 가입은 새 고객으로 만들어지며 이전 주문, 멤버십, 그룹과 연결되지 않습니다.

관리 IP 허용목록

tenant-admin은 설정 → 워크스페이스 접근에서 선택한 Live 워크스페이스 또는 Project에 속하지 않은 워크스페이스의 관리 IP 허용목록을 켤 수 있습니다. IPv4·IPv6 주소 또는 CIDR을 한 줄에 하나씩, 최대 100개 입력합니다. Sandbox는 같은 Project의 Live 정책을 따르므로 Live에서 변경하세요.

현재 접속 중인 공인 고정 IP 또는 VPN 대역을 포함한 뒤 저장하세요. 인증 앱의 새 6자리 코드를 입력하며, 실제 인증 요구 여부는 기존 MFA 정책을 따릅니다. 변경은 다음 보호 요청부터 적용됩니다.

다른 관리자가 먼저 변경했다면 페이지를 새로고침해 검토한 뒤 다시 저장하세요. 네트워크 오류로 결과를 알 수 없다면 새로고침하여 저장된 정책을 확인하세요.

켜진 정책은 Console 세션과 개인 PAT(CLI 포함)의 관리 요청을 제한합니다. 웹 요청도 검증된 원래 접속 IP로 판정합니다. 원본을 확인할 수 없으면 차단하고, 정책 판정 장애도 재시도가 가능해질 때까지 차단합니다.

Hosted MCP는 운영자의 접속망을 증명할 수 없어 관리 요청이 차단됩니다. 허용된 네트워크에서 Console 또는 개인 PAT를 사용하세요.

서비스 키·storefront·고객·공개 API·내부 작업에는 적용하지 않으며 공통 로그인은 바뀌지 않습니다. 이미 반환된 데이터나 외부 앱의 독립 세션·직접 URL을 회수하지 않습니다. 내장 앱의 새 실행은 워크스페이스 접근 판정을 거칩니다.

플랫폼 super-admin 세션과 해당 운영자의 개인 PAT는 IP 제한에서 제외되며 기존 MFA와 감사 통제는 유지됩니다. 잠겼다면 플랫폼 super-admin에게 기존 설정 권한으로 정책을 수정하도록 요청하세요. 복구 사유는 감사에 기록하며 별도 복구 역할은 없습니다.

미설정·비활성화 상태는 기존 접근을 유지합니다. 정책 변경은 감사와 함께 원자적으로 저장합니다. Live·독립 워크스페이스의 접근 거절 기록은 최선 노력 방식입니다. 기록된 접근·거부·정책 변경은 보안 이력에서 조회합니다.

다음 액션

목차