멤버들

조직 멤버는 Capgo 조직에 대한 접근 권한이 있는 사용자입니다. 각 멤버는 조직 내에서 권한을 결정하는 특정 역할을 가지고 있습니다. 멤버를 효과적으로 관리하는 것은 팀 내에서 보안과 협력을 유지하는 데 중요합니다.

멤버 역할

정규 역할

• 읽기: 리소스를 볼 수 있지만 변경을 할 수 없습니다
• 업로드: 새로운 번들 업로드 및 리소스 보기
• 쓰기: 리소스 수정 및 번들 업로드
• 관리자: 조직 설정 및 멤버 관리
• 슈퍼 관리자: 조직에 대한 전체 제어

초대 역할

• 초대 읽기: 읽기 접근 권한으로의 초대 중
• __CAPGO_KEEP_0__: 업로드 접근 초대 중
• : 쓰기 접근 초대 중: 관리자 접근 초대 중
• : 슈퍼 관리자 접근 초대 중: 최선의 관행
• : "최선의 관행" 섹션: 역할 할당

: 역할 할당 시 최소 권한 원칙을 따르세요.

1. __CAPGO_KEEP_0____CAPGO_KEEP_0__
2. 정규 감사: 사용자 접근 권한을 정기적으로 검토하고 사용하지 않는 계정을 제거합니다
3. 온보딩: 새로운 멤버를 추가하고 역할을 assign하는 명확한 프로세스를 가집니다
4. 오프보딩: 조직을 떠나는 멤버의 접근 권한을 즉시 제거합니다

엔드포인트

POST

https://api.capgo.app/organization/members/

조직에 새로운 멤버를 추가하거나 기존 멤버의 역할을 업데이트합니다. 사용자에게 Capgo 계정을 초대할 수 있습니다 - 이메일은 이미 Capgo 사용자와 일치해야 합니다.

요청 본문

interface MemberCreate {
  orgId: string
  email: string
  role: "read" | "upload" | "write" | "admin" | "super_admin"
}

__CAPGO_KEEP_0__

curl -X POST \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_123",
    "email": "newmember@example.com",
    "role": "write"
  }' \
  https://api.capgo.app/organization/members/

__CAPGO_KEEP_0__

{
  "status": "OK",
  "data": {
    "uid": "user_789",
    "email": "newmember@example.com",
    "role": "invite_write",
    "image_url": null
  }
}

__CAPGO_KEEP_0__

• __CAPGO_KEEP_0__
• Capgo https://console.capgo.app/register/

GET

https://api.capgo.app/organization/members/

조직의 모든 멤버를 가져옵니다.

Query Parameters

interface MemberQuery {
  orgId: string
}

응답 형식

interface Member {
  uid: string;
  email: string;
  image_url: string;
  role: "invite_read" | "invite_upload" | "invite_write" | "invite_admin" | "invite_super_admin" | "read" | "upload" | "write" | "admin" | "super_admin";
}

예제 요청

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/organization/members/?orgId=org_123"

예시 응답

{
  "data": [
    {
      "uid": "user_123",
      "email": "john@example.com",
      "image_url": "https://example.com/avatar.png",
      "role": "admin"
    },
    {
      "uid": "user_456",
      "email": "jane@example.com",
      "image_url": "https://example.com/avatar2.png",
      "role": "write"
    },
    {
      "uid": "user_789",
      "email": "bob@example.com",
      "image_url": null,
      "role": "invite_read"
    }
  ]
}

DELETE

https://api.capgo.app/organization/members/

요청 본문

요청 본문 섹션

interface MemberDelete {
  orgId: string
  email: string
}

__CAPGO_KEEP_0__

curl -X DELETE \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_123",
    "email": "user@example.com"
  }' \
  https://api.capgo.app/organization/members/

성공 응답

{
  "status": "OK"
}

오류 처리

일반 오류 시나리오 및 응답:

// Member not found
{
  "error": "Member not found",
  "status": "KO"
}

// Invalid role
{
  "error": "Invalid role specified",
  "status": "KO"
}

// Permission denied
{
  "error": "Insufficient permissions to manage members",
  "status": "KO"
}

// Cannot remove last admin
{
  "error": "Cannot remove the last admin from the organization",
  "status": "KO"
}

// Invalid email
{
  "error": "Invalid email format",
  "status": "KO"
}

// Member already exists
{
  "error": "Member already exists in organization",
  "status": "KO"
}

일반적인 사용 사례

1. 팀 확장: 새로운 팀원 추가 및 역할 부여
2. 권한 관리: 역할 변경에 따라 팀원 권한 관리
3. 안전 감사: 팀원 목록 및 역할을 정기적으로 검토
4. 조직 구조 변경: 조직 구조 변경 시 역할 업데이트

__CAPGO_KEEP_0__

If you are using __CAPGO_KEEP_2__ 보안 및 규정 준수 계획을 수립하기 위해 연결하세요. 암호화 __CAPGO_KEEP_0__ 암호화 구현 세부 정보에 대해 규정 준수 __CAPGO_KEEP_0__ 규정 준수 구현 세부 정보에 대해 Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로에 대해 Capgo 보안 Capgo 보안의 제품 워크플로에 대해 Capgo 신뢰 센터 Capgo 신뢰 센터의 제품 워크플로에 대해