회원 목록

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

멤버 역할

정규 역할

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

Invite Roles

• 초대 읽기읽기 접근 허용待정
• invite_upload업로드 접근 허용待정
• invite_write쓰기 접근 허용待정
• invite_admin관리자 접근 허용待정
• invite_super_admin슈퍼 관리자 접근 허용待정

Best Practices

1. 역할 assignments: 권한이 가장 적은 원칙에 따라 역할을 할당하십시오.
2. 정기적인 감사: 조직에서 사용하지 않는 계정 제거를 위해 회원 접근을 정기적으로 검토하십시오.
3. 온보딩: 새로운 회원을 추가하고 역할을 할당하는 명확한 프로세스를 갖으십시오.
4. 오프보딩: 조직에서 떠난 회원의 접근을 즉시 제거하십시오.

엔드포인트

POST

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

조직에 새로운 회원을 추가하거나 기존 회원의 역할을 업데이트하십시오. 참고로, 이미 Capgo 계정이 있는 사용자만 초대할 수 있습니다 - 이메일은 이미 Capgo 사용자와 일치해야 합니다.

__CAPGO_KEEP_0__

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

__CAPGO_KEEP_3__

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_6__

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

__CAPGO_KEEP_7__

• __CAPGO_KEEP_8__
• Capgo 계정이 이미 있는 사용자만 초대할 수 있습니다. 계정이 없다면 Capgo 계정을 먼저 생성하세요. https://console.capgo.app/register/

GET

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

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

Query Parameters

interface MemberQuery {
  orgId: string
}

Response Type

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";
}

Example Request

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

Example Response

{
  "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/

조직에서 멤버를 제거합니다. 즉시 접근 권한을 취소합니다.

Request Body

interface MemberDelete {
  orgId: string
  email: string
}

예시 요청

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. 팀 구조 변경: 조직 구조 변경 시 역할 업데이트

Keep going from Members

Capgo를 사용 중이라면 회원 __CAPGO_KEEP_0__과 연결하여 보안 및 규정 준수 계획을 수립하세요. 암호화 __CAPGO_KEEP_0__ 암호화 구현 세부 정보 규정 준수 __CAPGO_KEEP_0__ 규정 준수 구현 세부 정보 Capgo 보안 스캐너 Capgo 보안 스캐너 제품 워크플로우 Capgo 보안 Capgo 보안 제품 워크플로우 Capgo 신뢰 센터 Capgo 신뢰 센터 제품 워크플로우