조직

조직은 여러 사용자가 공유할 수 있도록 하나의 소유자 아래에 자격 증명을 그룹화합니다. JSON API용 API key와 proxy 포트용 proxy user가 여기에 해당합니다. 조직의 자격 증명으로 사용된 모든 비용은 request를 보낸 사람이 아니라 조직 소유자의 플랜에 청구됩니다.

확인 위치

대시보드에 로그인한 후 사이드바에서 Organizations를 엽니다. 내가 속한 모든 조직이 하나의 행으로 표시됩니다.

열	표시 내용
Organization	조직 이름입니다. 이름을 클릭하거나 Open을 클릭하여 해당 조직 전용 페이지로 이동합니다.
Your role	Owner, Admin 또는 Member
Members	소유자를 포함하여 조직에 속한 총 인원수
Keys	조직이 소유한 API key 수
Created	조직 생성 시점
Actions	Open

조직 생성

New organization을 클릭하고 2~60자 사이의 이름을 입력한 후 확인합니다. 생성자가 소유자가 됩니다. 이름에는 영문자 또는 숫자가 1자 이상 포함되어야 하며, 기존 조직 이름과 중복될 수 없습니다 (문자와 숫자만 비교하며 그 외 요소는 무시됩니다).

조직을 생성하려면 2인 이상을 지원하는 플랜이 필요합니다. 지원 여부는 Usage & Limits의 Organizations you own 행에서 확인할 수 있습니다.

역할

세 가지 역할이 있으며, 모든 조직에는 정확히 한 명의 소유자만 존재합니다.

역할	권한
Member	조직의 API key 및 proxy user 생성과 사용, API key 이름 변경, 조직의 멤버 및 팀 조회
Admin	멤버의 모든 권한을 포함하며, 사용자 추가 및 삭제, 역할 변경, 조직의 모든 자격 증명 관리, 조직 이름 변경
Owner	관리자의 모든 권한을 포함하며, 조직 소유권 이전 가능. 소유자는 조직의 모든 자격 증명 사용량이 청구되는 플랜을 보유함.

소유자는 삭제되거나 탈퇴할 수 없으며, 역할을 강등할 수도 없습니다. 소유권은 이전(transfer)을 통해서만 한 방향으로 이동합니다.

조직에 속해 있어야 해당 자격 증명에 접근할 수 있습니다. 관리자 권한이 없는 멤버도 회사가 비용을 지불하는 key나 proxy user를 생성할 수 있습니다. 이는 수집기를 개발하는 개발자가 회사 대신 개인 비용으로 청구되는 개인 자격 증명을 사용할 필요가 없도록 하기 위함입니다.

조직 페이지

행에서 Open을 클릭하면 해당 조직 페이지로 이동합니다. 상단에는 Members (하단에 소유자, 관리자, 멤버 구분 표시), Your role, Owner, API keys, Proxy users, Teams 등 6개의 카드가 있습니다. 그 아래에는 2개의 탭이 있습니다.

Members: 조직에 속한 사용자와 본인의 역할에 따라 부여된 관리 기능이 표시됩니다.
Teams: 이 조직 내에서 본인이 속한 팀이 표시되며, 읽기 전용입니다.

소유자와 관리자에게는 페이지 헤더에 Rename 버튼도 표시됩니다.

사용자 추가

소유자와 관리자에게는 Members 테이블 위에 Add a member 카드가 표시됩니다. 이메일 주소를 입력하고 Member 또는 Admin을 선택한 다음 제출합니다.

이후 진행 과정은 이메일 주소의 상태에 따라 다르며 대시보드에 결과가 표시됩니다.

해당 주소에 이미 FourA 계정이 있는 경우: 즉시 참여 처리되며, 조직 이름, 초대한 사람, 해당 역할의 권한이 명시된 이메일을 받습니다.
계정이 없는 경우: FourA에서 초대 이메일을 발송하며, 해당 주소로 로그인하는 즉시 참여하게 됩니다. 링크를 클릭할 필요가 없으며, 신규 가입하거나 이전에 개설 후 사용하지 않은 계정이라도 초대가 정상 적용됩니다.

초대는 14일 후에 만료됩니다. 동일한 주소를 다시 추가하면 초대가 중복 추가되지 않고 대기 중인 초대가 갱신됩니다.

새로 참여한 멤버는 소유자의 크레딧을 사용하므로, 누군가 참여할 때마다 소유자에게 이메일이 발송됩니다. 본인의 작업에 대해서는 확인 이메일이 발송되지 않습니다.

대기 중인 초대

대기 중인 초대가 하나 이상 있으면 Members 위에 Invitations 테이블이 표시되며, 소유자와 관리자에게만 보입니다. 여기에는 이메일 주소, 부여될 역할, 초대한 사람 및 초대 일시가 나열됩니다. 만료된 초대도 표시가 유지되고 구분되므로 참여하지 않은 이유를 확인할 수 있습니다. 행의 작업을 사용하여 초대를 취소할 수 있습니다.

역할 변경

소유자와 관리자는 Role 열의 드롭다운을 통해 멤버의 역할을 Member와 Admin 사이에서 변경할 수 있습니다. 3가지 규칙이 적용됩니다.

자신의 역할은 직접 변경할 수 없습니다. 다른 관리자에게 요청하거나 조직에서 나가야 합니다.
소유자의 역할은 여기에서 편집할 수 없습니다. 대신 Make owner를 사용하세요.
역할을 변경할 때마다 확인 메시지가 표시되며 변경 후 수행할 수 있는 작업이 안내됩니다.

멤버 제거 및 탈퇴

소유자와 관리자는 본인 및 소유자 행을 제외한 모든 행에서 Remove를 사용할 수 있습니다. 본인의 행에는 역할에 관계없이 Leave가 표시됩니다.

멤버를 제거하면 조직의 팀에서도 제외되므로 조직의 자격 증명을 즉시 볼 수 없게 됩니다. 자격 증명 자체는 삭제되지 않습니다. 조직의 키나 proxy 사용자는 생성자가 아닌 조직에 귀속됩니다.

소유자는 제거될 수 없으며 탈퇴할 수도 없습니다. 먼저 조직 소유권을 이전해야 합니다.

조직 소유권 이전

소유자만 이 작업을 수행할 수 있습니다. Members 탭에서 소유권을 이전할 사용자의 Make owner를 클릭하고 확인합니다.

조직이 해당 사용자의 플랜으로 전환됩니다. 그 시점부터 조직의 키가 생성하는 모든 request와 proxy 사용자가 여는 모든 터널은 해당 사용자의 크레딧, 트래픽, 한도 및 청구서에 반영됩니다. 이전 소유자는 관리자로 전환되며 관리자의 모든 권한을 그대로 유지합니다.

키 접근 권한

조직이 소유한 모든 키는 조직 내 모든 구성원에게 표시됩니다. 차이점은 키로 수행할 수 있는 작업의 권한입니다.

Action	Member	Admin	Owner
키 사용, 키 표시, 조직의 새 키 생성	Yes	Yes	Yes
키 이름 변경, 설명 편집	Yes	Yes	Yes
재생성, 비활성화, 삭제	No	Yes	Yes
키를 조직 외부로 이전	No	No	Yes

키 이름을 바꾸는 것은 안전합니다. 키를 재생성하거나 비활성화하면 해당 키를 사용하는 모든 동료의 작업이 즉시 중단되므로 관리자만 이 작업을 수행할 수 있습니다. 키를 외부로 이전하면 자산이 조직에서 제거되고 사용량이 이전받은 사람의 플랜으로 이동하므로, 이 작업은 소유자만 수행할 수 있습니다.

전체 안내는 Managing API Keys를 참고하십시오.

표시되는 프록시 사용자

프록시 사용자 역시 동일한 이유로 세 가지 권한 수준을 따릅니다.

Action	Member	Admin	Owner
사용, 비밀번호 확인, 새 사용자 생성	Yes	Yes	Yes
새 비밀번호 생성, 비활성화, 삭제, 저장된 타겟팅 변경	No	Yes	Yes
조직 외부로 이전	No	No	Yes

저장된 타겟팅을 변경하면 해당 자격 증명으로 조직 전체에서 생성하는 모든 연결 대상이 즉시 변경되므로 일반 구성원이 아닌 관리자만 수정할 수 있습니다. 비밀번호 재설정 역시 자격 증명이 이미 입력된 모든 구성 파일을 손상시키므로 관리자 권한이 필요합니다.

조직의 다운로더는 조직의 프록시 사용자를 사용해야 합니다. 개인 프록시 사용자는 해당 사용자가 퇴사하는 즉시 작동을 멈추고 개인에게 요금이 청구됩니다. 자세한 안내는 Proxy Users를 참고하십시오.

소유자 필터

조직에 소속되면 Overview, Metrics, Activity, API Keys, Proxy 상단에 Owner 드롭다운이 나타납니다. 여기에는 Everything, Personal, 그리고 조직별 항목의 세 가지 옵션이 제공됩니다. 선택한 설정은 페이지를 다시 방문해도 유지되며 위 5개 페이지 모두에 적용됩니다.

Usage & Limits 및 Billing 페이지에는 이 필터가 적용되지 않습니다. 이 페이지들은 "무엇을 볼 수 있는가"가 아니라 "누구에게 요금이 청구되는가"를 보여주며, 일반 구성원은 소유자의 할당량을 볼 수 없습니다.

청구 귀속

누가 실행했든 관계없이 조직 소유 키로 수행된 모든 요청과 조직 소유 프록시 사용자로 열린 모든 터널은 조직 소유자에게 청구됩니다. 자격 증명을 조직으로 이전하는 주된 이유는 크레딧, 트래픽, 플랜 한도, 인보이스 청구 대상을 변경하기 위함입니다.

소유자의 Usage & Limits 페이지에서는 API keys 탭과 Proxy users 탭에서 개인 자격 증명과 조직 자격 증명을 함께 계산하며, 지출 출처를 명확히 알 수 있도록 둘을 구분하여 표시합니다.

팀

모든 조직에는 Everyone이라는 기본 팀이 생성됩니다. 새 키는 이 팀에 자동으로 분류되며, 조직에 참여하는 모든 사람이 팀에 추가되므로 구성원이 키에 접근할 수 있게 됩니다.

Teams 탭에는 내가 속한 팀 목록과 각 팀에서의 역할, 구성원 수, 사용 가능한 키 목록(Keys you can use)이 표시됩니다. 대시보드에서 팀을 생성하고 편집하는 기능은 아직 지원되지 않습니다.

조직