__CAPGO_KEEP_0__

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

メンバーの役割

通常の役割

• read: リソースを表示できますが、変更はできません
• アップロード:新しいバンドルをアップロードしリソースを表示できます
• 書き込み:リソースを変更しバンドルをアップロードできます
• 管理者:組織の設定とメンバーを管理できます
• 超管理者:組織の全ての制御権を持ちます

招待ロール

• :読み取り権の招待中:招待中の読み取り権
• 招待アップロード: アップロードアクセスの招待待ち
• 招待書き込み: 書き込みアクセスの招待待ち
• 招待管理者: 管理者アクセスの招待待ち
• 招待最高管理者: 最高管理者アクセスの招待待ち

ベスト プラクティス

1. ロール割り当て: 最小特権原則に基づいてロールを割り当てる
2. 通常の監査: メンバーのアクセスを定期的に確認し、未使用のアカウントを削除する
3. 加入: 組織に新しいメンバーを追加するための明確なプロセスを確立する
4. 退会: 組織から離れたメンバーのアクセスを即座に削除する

エンドポイント

POST

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

組織に新しいメンバーを追加するか、既存のメンバーの役割を更新する。ただし、既存の Capgo アカウントを持っているユーザーのみを招待できることに注意してください - メールアドレスは、既存の Capgo ユーザーと一致する必要があります。

リクエスト本文

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

注意:

• 新しいメンバーを追加する場合、メンバーは招待メールを受信します。 彼らの役割は、招待を受け入れるまで「invite_」でプレフィックスされます。
• Capgo アカウントを持っている必要があります。 アカウントがなければ、まず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"
    }
  ]
}

DELETE

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

リクエストボディ

「リクエストボディ」のセクション

interface MemberDelete {
  orgId: string
  email: string
}

DELETEのセクション

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. チーム拡大__CAPGO_KEEP_0__：新しいチームメンバーを適切な役割で追加
2. アクセス制御__CAPGO_KEEP_0__：メンバーの権限を変更する際の責任の変化を管理
3. セキュリティアウディット__CAPGO_KEEP_0__：メンバーのリストと役割を定期的に確認
4. チーム再構築__CAPGO_KEEP_0__：組織の変更の際に役割を更新

メンバーから続けて

__CAPGO_KEEP_0__：あなたは__CAPGO_KEEP_1__を使用している場合 __CAPGO_KEEP_0__：メンバー セキュリティとコンプライアンスの計画に役立つためにつなぎます。 暗号化 __CAPGO_KEEP_0__ セキュリティ スキャナの実装詳細のため コンプライアンス __CAPGO_KEEP_0__ トラスト センターの製品ワークフローのため Capgo セキュリティ Capgo セキュリティ スキャナの製品ワークフロー Capgo トラスト センター Capgo セキュリティの製品ワークフロー Capgo Trust Center Capgo