Ephemeral의 모든 것은 조직에 속합니다. 사람은 역할을 가지고 조직에 참여하고, 소프트웨어는 자체 역할을 가진 조직 API 키를 사용합니다. 두 종류의 역할은 서로 별개입니다.
사람
| 역할 | 가능한 작업 |
|---|---|
| 소유자 | 관리자가 할 수 있는 모든 작업에 더해 역할 변경, 관리자 제거, 소유권 이전. 조직마다 소유자는 한 명입니다. |
| 관리자 | 멤버가 할 수 있는 모든 작업에 더해 연결, 멤버, 초대, API 키, 결제, 배포 라이선스 관리. |
| 멤버 | 실행 시작, 조회, 취소. 파일과 워크플로 관리. 이름으로 연결 사용. |
조직을 만든 사람이 소유자가 됩니다. 관리자는 사람을 관리자나 멤버로 초대하고 멤버를 제거할 수 있습니다. 관리자를 제거하거나 다른 사람의 역할을 바꿀 수 있는 것은 소유자뿐입니다. 소유자는 제거할 수 없습니다. 물러나려면 기존 멤버에게 소유권을 이전하세요. 그 멤버가 소유자가 되고 본인은 관리자가 됩니다.
API 키
API 키는 소속 조직을 대신해 동작합니다. 키마다 만들 때 선택한 member 또는 admin 역할이 있습니다. 키의 비밀 값은 한 번만 표시됩니다. 서버에 보관하고, 유출되면 키를 폐기하세요. 폐기는 즉시 적용됩니다.
- 실행을 시작하는 애플리케이션 코드에는 member 키를 사용합니다. 기본값입니다.
- 연결을 만들거나 변경해야 하는 신뢰할 수 있는 설정 도구에만 admin 키를 사용하세요.
두 역할 모두 조직 전체에 적용됩니다. member 키라고 해서 읽기 전용은 아니며, 특정 워크플로나 파일로 범위를 제한할 수 있는 키도 없습니다. 그런 분리가 필요하면 조직을 따로 두세요.
역할별 가능한 작업
| 작업 | 멤버 사용자 또는 키 | 관리자 키 | 소유자 또는 관리자 사용자 |
|---|---|---|---|
| 실행 시작, 조회, 취소 | 가능 | 가능 | 가능 |
| 파일 업로드, 이름 변경, 삭제 | 가능 | 가능 | 가능 |
| 워크플로 저장, 삭제 | 가능 | 가능 | 가능 |
| 사용 가능한 연결 조회 및 이름으로 사용 | 가능 | 가능 | 가능 |
| 연결 설정 조회·변경, OAuth 시작 | 불가 | 가능 | 가능 |
| 멤버, 초대, API 키, 결제, 라이선스 관리 | 불가 | 불가 | 가능 |
관리자 키로는 조직을 관리할 수 없습니다
호스팅 서비스에서 멤버, 초대, API 키, 크레딧, 배포 라이선스는 로그인한 소유자나 관리자만 관리할 수 있습니다. 관리자 API 키는 이런 작업에서 거부되므로, 키가 유출되어도 크레딧을 구매하거나, 사람을 추가하거나, 새 키를 발급할 수 없습니다.
호스팅 키와 셀프 호스팅 키
| 호스팅 서비스 | 셀프 호스팅 설치본 | |
|---|---|---|
| 키 접두사 | eak_ | eph_ |
| 생성 위치 | 대시보드의 API 키 또는 조직 API | 대시보드의 키 또는 POST /v1/keys |
| 키를 만들 수 있는 사람 | 로그인한 소유자 또는 관리자 | 관리자 키 |
| 첫 번째 키 | 가입 후 직접 생성 | 설정 중 부트스트랩 요청으로 발급 |
셀프 호스팅 설치본에는 고객 계정이 없으므로, 관리자 키가 설치본의 키도 관리합니다. 첫 번째 키는 셀프 호스팅을, 호스팅 서비스의 키 엔드포인트는 조직을 참고하세요.
호스팅 대시보드에서는 개인으로 로그인해 멤버십 역할로 동작합니다. 브라우저 요청은
X-Ephemeral-Organization 헤더로 조직을 선택하며, API 키는 이미 하나의 조직에 속해 있습니다.