멤버

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

멤버 역할

정규 역할

• 읽기: 자원 보기만 가능, 변경 불가
• 업로드: 새로운 패키지 업로드 및 자원 보기
• 쓰기: 자원 수정 및 패키지 업로드
• 관리자: 조직 설정 및 멤버 관리
• 슈퍼 관리자: 조직 전체 제어

초대 역할

• __CAPGO_KEEP_0__읽기 권한 초대 중
• 업로드 권한 초대 중쓰기 권한 초대 중
• 관리자 초대 중슈퍼 관리자 초대 중
• Best Practices__CAPGO_KEEP_0__
• __CAPGO_KEEP_0____CAPGO_KEEP_0__

__CAPGO_KEEP_0__

1. 역할 할당: 최소 권한 원칙을 따르면 역할을 할당하십시오
2. 정기적인 감사: 회원 접근을 정기적으로 검토하고 사용하지 않는 계정을 삭제하십시오
3. 온보딩: 새로운 회원을 추가하는 데 대한 명확한 프로세스를 갖고 계십시오
4. 오프보딩: 조직을 떠나는 회원의 접근 권한을 즉시 제거하십시오

Endpoints

POST

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

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

Request Body

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

예제 요청

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/

성공 응답

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

Notes:

• 새 멤버를 추가할 때, 그들은 초대 이메일을 받게 됩니다. 그들의 역할은 초대 받을 때까지 “invite_”로 시작하게 됩니다.
• 사용자는 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";
}

예시 요청

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

삭제

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

DELETE

섹션 제목 "DELETE"

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

멤버에서 계속

만약에 당신이 멤버들 을 사용하여 보안 및 규정 준수 계획을 세우고 있다면 암호화 을 암호화 의 구현 세부 정보와 연결하세요. Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo Security for the product workflow in Capgo Security, and Capgo 신뢰 센터 Capgo 신뢰 센터에 대한 제품 워크플로우.