メンバー

組織メンバーは、組織Capgoにアクセスできるユーザーです。各メンバーには、組織内での権限を決定する特定のロールがあります。組織のセキュリティとコラボレーションを維持するために、メンバーの管理は重要です。

メンバーのロール

通常のロール

• read: リソースを参照できますが、変更は行えません
• upload: 新しいバンドルをアップロードし、リソースを参照できます
• write: リソースを変更し、バンドルをアップロードできます
• admin: 組織の設定とメンバーを管理できます
• super_admin: 組織の全ての制御権を持ちます

Invite Roles

• __CAPGO_KEEP_0__読み取り権限の招待待ち
• __CAPGO_KEEP_0__アップロード権限の招待待ち
• __CAPGO_KEEP_0__書き込み権限の招待待ち
• __CAPGO_KEEP_0__管理者権限の招待待ち
• __CAPGO_KEEP_0__超管理者権限の招待待ち

ベスト プラクティス

1. 役割の割り当て: 最小限の特権原則に従って役割を割り当てます
2. 定期的な検査: メンバーのアクセスを定期的に確認し、使用されていないアカウントを削除します
3. 加入: 新しいメンバーを追加するための明確なプロセスを持ち、役割を割り当てます
4. 退会: 組織を離れたメンバーのアクセスを即座に削除します

Section titled “Endpoints”

text

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/

Success Response

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

注記:

• 新メンバーを追加する場合、招待メールを受け取ることになります。招待を受け入れるまで、役割は「invite_」で始まります。
• ユーザーはすでにCapgoアカウントを持っている必要があります。アカウントがなければ、まず https://console.capgo.app/register/

GET

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

組織の全員を取得します。

クエリパラメータ

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

削除

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

組織からメンバーを削除します。このアクセスを即時で取り消します。

リクエストボディ

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. チームの再構成:組織の変更に伴う役割の更新

メンバーから続けて

あなたが「 メンバー」を使用している場合 セキュリティとコンプライアンスの計画に利用している場合 Encryption Encryption __CAPGO_KEEP_0__ セキュリティ スキャナー __CAPGO_KEEP_0__ セキュリティ スキャナー Capgo セキュリティ Capgo セキュリティ Capgo Security for the product workflow in Capgo Security, and Capgo の信頼センター Capgo の製品ワークフローについての信頼センター