Universal 목록
SWDEV / 가이드 배포자료

SW_DEV Access 사용 가이드

redtree2379@swdev.co.kr2026. 10. 30.· 2026. 10. 30. 수정
#swdev#access#권한관리#api키#멤버초대

access-01-members

Access는 Planet의 멤버와 권한을 관리하는 App입니다. 멤버를 초대해 역할을 주고 App마다 누가 무엇을 할 수 있는지 정합니다. 외부 프로그램에서 쓸 API 키도 여기서 발급합니다. 멤버가 어떤 기능을 언제 썼는지는 기록으로 남습니다.

화면에 나오는 Planet, 이름, 이메일, 키는 모두 설명용 예시입니다.

한눈에 보기

메뉴 하는 일
Members 멤버 초대, 역할 변경, 제거
Authorization App별로 조회 · 생성 · 수정 · 삭제에 필요한 최소 역할 정하기
API 외부 연동용 API 키 발급과 범위 · 유효기간 관리
Flag 멤버별 · 엔드포인트별 사용 기록 보기

Access 화면은 처음에는 Owner와 Admin만 쓸 수 있습니다.

1. 멤버 초대하기 (Members)

Members에는 Planet에 들어와 있는 멤버와 아직 수락하지 않은 초대가 함께 나옵니다. 맨 위 화면에는 Owner 한 명과 대기 중인 초대 두 건이 보입니다.

오른쪽 위 멤버 초대를 누르고 이메일과 역할을 고르면 초대 메일이 나갑니다. 초대는 7일 동안 유효합니다. 받은 사람이 그 이메일로 가입하거나 로그인한 뒤 대시보드에서 수락하면 고른 역할로 Planet에 들어옵니다.

access-02-invite

역할은 네 가지입니다.

  • Owner: Planet을 만든 사람입니다. 정책과 상관없이 모든 권한을 가집니다.
  • Admin: 멤버를 초대하고 역할을 관리하며 Access · Secret 같은 관리용 App을 씁니다.
  • Member: 일반 App을 씁니다.
  • Viewer: 일반 App을 조회만 합니다.

역할은 멤버 줄의 연필 아이콘으로 바꿉니다. 대기 중인 초대는 오른쪽 X로 취소합니다. Admin의 역할을 바꾸거나 Admin을 내보내는 일은 Owner만 할 수 있습니다.

2. App별 권한 정하기 (Authorization)

Authorization에서는 App마다 조회 · 생성 · 수정 · 삭제에 필요한 최소 역할을 고릅니다. 예를 들어 Report의 생성을 'Member 이상'으로 두면 Viewer는 문서를 읽기만 합니다.

access-03-permissions

처음에는 App 성격에 맞춘 기본값이 들어 있습니다. Access · Secret · Gateway는 Admin 이상만 씁니다. Report는 Viewer가 읽고 Member부터 씁니다. Agent는 에이전트 관리를 Admin 이상이 하고 GenAI 대화는 Member부터 할 수 있습니다. 칸 아래에 역할마다 실제로 할 수 있는 일이 요약돼 나오니 바꾸기 전에 확인하면 됩니다.

3. API 키 발급하기 (API)

외부 프로그램에서 Gateway나 Agent를 부를 때 쓰는 키입니다. 모델 회사의 키가 아니라 SW_DEV가 발급하는 키이며 swd_로 시작합니다.

access-04-apikeys

키 발급을 누르고 이름과 범위, 유효기간을 정합니다.

access-05-apikey-new

  • 범위는 이 키로 부를 수 있는 서비스입니다. Gateway(AI 모델 호출)와 Agent(배포한 에이전트 실행) 중에서 고릅니다. 범위에 없는 서비스를 부르면 403 오류가 납니다.
  • 내가 조회 권한을 갖지 않은 App은 범위로 고를 수 없습니다.
  • 키 원문은 발급할 때 한 번만 보입니다. 창을 닫기 전에 복사해 두십시오.
  • 쓰는 곳마다 키를 따로 만들어 두면 사용량을 나눠 볼 수 있고, 키가 새어 나가도 그 키만 폐기하면 됩니다.

목록 오른쪽 아이콘으로 이름 · 범위 · 유효기간을 고치거나(수정), 새 원문을 받거나(재발급), 키를 없앱니다(폐기). 재발급하면 이전 원문은 바로 못 쓰게 됩니다. 폐기한 키는 목록에서 사라집니다. 바꾼 내용은 길어야 60초 뒤에 반영됩니다.

키를 쓰는 방법은 화면 맨 아래 Docs를 누르면 나오는 API 문서에 있습니다.

4. 사용 기록 보기 (Flag)

Flag에는 멤버가 어떤 App의 어떤 기능(엔드포인트)을 언제 썼는지가 남습니다. 멤버별이나 엔드포인트별로 묶어 보고 기간과 App으로 범위를 좁힙니다. 요청이 유난히 많은 멤버나 오류가 몰리는 기능을 찾을 때 쓰면 좋습니다.

access-06-flags

댓글 0 조회 1

댓글

등록된 댓글이 없습니다.