Miembros

Los miembros de la organización son usuarios que tienen acceso a tu Capgo organización. Cada miembro tiene un rol específico que determina sus permisos dentro de la organización. El manejo de los miembros de manera efectiva es crucial para mantener la seguridad y la colaboración en tu equipo.

Roles de Miembros

Roles regulares

• leer: Puede ver recursos pero no puede hacer cambios
• subir: Puede subir nuevos paquetes y ver recursos
• escribir: Puede modificar recursos y subir paquetes
• administrador: Puede gestionar ajustes de organización y miembros
• super_admin: Tiene control total sobre la organización

Roles de invitación

• invite_read: Invitación pendiente para acceso de lectura
• invite_upload: Invitación pendiente para acceso de carga
• invite_write: Invitación pendiente para acceso de escritura
• invite_admin: Invitación pendiente para acceso de administración
• invite_super_admin: Espera de invitación para acceso de administrador super

Prácticas recomendadas

1. Asignación de rol: Sigue el principio de privilegios más bajos cuando se asignan roles
2. Revisión regular: Revisa periódicamente el acceso de los miembros y elimina cuentas no utilizadas
3. Integración: Tienes un proceso claro para agregar nuevos miembros y asignar roles
4. Desvinculación: Elimina con prontitud el acceso para los miembros que dejan la organización

Puntos de conexión

POST

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

Agregar a un nuevo miembro a una organización o actualizar el rol de un miembro existente. Tenga en cuenta que solo puede invitar a usuarios que ya tienen una cuenta Capgo - el correo electrónico debe corresponder a un usuario Capgo existente.

Cuerpo de la solicitud

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

Solicitud de ejemplo

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/

Respuesta de éxito

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

Notas:

• Cuando se agrega un nuevo miembro, recibirán un correo electrónico de invitación. Su rol se prefijará con “invite_” hasta que acepten la invitación.
• El usuario debe tener ya una cuenta de Capgo antes de que puedan ser invitados. Si no tienen una cuenta, deberían crear una primero en https://console.capgo.app/register/

GET

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

Recuperar a todos los miembros de una organización.

Parámetros de consulta

interface MemberQuery {
  orgId: string
}

Tipo de respuesta

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

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Eliminar

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

Eliminar a un miembro de una organización. Esto revocará inmediatamente su acceso.

Cuerpo de la solicitud

interface MemberDelete {
  orgId: string
  email: string
}

Pedido de ejemplo

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/

Respuesta de éxito

{
  "status": "OK"
}

Manejo de Errores

Escenarios de errores comunes y sus respuestas:

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

Uso Común

1. Ampliación del Equipo: Agregar nuevos miembros del equipo con roles adecuados
2. Control de Acceso: Administrar permisos de miembros según cambien las responsabilidades
3. Revisión de Seguridad: Revisar lista de miembros y roles periódicamente
4. Equipo de reestructuración: Actualizando roles durante cambios organizacionales

Sigue adelante desde Miembros

Si estás utilizando Miembros para planificar la seguridad y la conformidad, conecta con Cifrado para el detalle de implementación en Cifrado, Conformidad para el detalle de implementación en Conformidad, Capgo Escáner de Seguridad para el flujo de trabajo del producto en Capgo Escáner de Seguridad, Capgo Seguridad para el flujo de trabajo del producto en Capgo Seguridad, y Capgo Centro de Confianza para el flujo de trabajo del producto en Capgo Centro de Confianza.