Membri

Gli utenti dell'organizzazione sono coloro che hanno accesso alla tua Capgo organizzazione. Ogni membro ha un ruolo specifico che determina le loro autorizzazioni all'interno dell'organizzazione. Gestire gli utenti in modo efficace è fondamentale per mantenere la sicurezza e la collaborazione nel tuo team.

Ruoli dei membri

Ruoli regolari

• lettura: Può visualizzare le risorse ma non può fare modifiche
• carica: Può caricare nuovi bundle e visualizzare le risorse
• scrittura: Può modificare le risorse e caricare i bundle
• amministratore: Può gestire le impostazioni e i membri dell'organizzazione
• super_amministratore: Ha il controllo completo sull'organizzazione

Sezione "Invita Ruoli"

• : Invito in attesa per l'accesso di letturainvito_carica
• : Invito in attesa per l'accesso di caricamentoinvito_scrivi
• : Invito in attesa per l'accesso di scrittura__CAPGO_KEEP_0__
• invita_amministratore: Invito in attesa per l'accesso amministratore
• invita_super_amministratore: Invito in attesa per l'accesso super amministratore

Pratiche Migliori

1. Assegnazione Ruoli: Seguire il principio di minor privilegio quando assegnare ruoli
2. Verifiche Regolari: Recensire periodicamente l'accesso dei membri e rimuovere gli account non utilizzati
3. Onboarding: Avere un processo chiaro per l'aggiunta di nuovi membri e l'assegnazione di ruoli
4. Disconnessione: Rimuovi immediatamente l'accesso per i membri che lasciano l'organizzazione

Punti di accesso

POST

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

Aggiungi un nuovo membro a un'organizzazione o aggiorna il ruolo di un membro esistente. Nota che puoi invitare solo gli utenti che già hanno un account Capgo - l'indirizzo email deve corrispondere a un utente esistente Capgo.

Corpo della richiesta

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

Esempio di richiesta

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/

Risposta di successo

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

Nota:

• Quando si aggiunge un nuovo membro, riceveranno un'email di invito. Il loro ruolo sarà prefissato con “invite_” fino a quando non accettano l'invito.
• L'utente deve già avere un account Capgo prima di poter essere invitato. Se non ne ha uno, dovrebbe crearne uno per primo a https://console.capgo.app/register/

GET

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

Recupera tutti i membri di un'organizzazione.

Parametri di query

interface MemberQuery {
  orgId: string
}

Tipo di risposta

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

Richiesta di esempio

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

Risposta di esempio

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

CANCELLA

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

Rimuovi un membro da un'organizzazione. Ciò revocherà immediatamente il loro accesso.

Corpo della richiesta

interface MemberDelete {
  orgId: string
  email: string
}

Esempio di richiesta

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/

Risposta di successo

{
  "status": "OK"
}

Gestione degli errori

Scenari di errore comuni e relative risposte:

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

Casi d'uso comuni

1. Espansione della squadra: Aggiunta di nuovi membri della squadra con ruoli appropriati
2. : Gestione delle autorizzazioni dei membri in base ai cambiamenti delle responsabilità: Gestione delle autorizzazioni dei membri in base ai cambiamenti delle responsabilità
3. Audit di Sicurezza: Revisione della lista dei membri e dei ruoli con cadenza periodica
4. Ristrutturazione del Team: Aggiornamento dei ruoli durante le modifiche organizzative

Continua da Membri

Se stai utilizzando Membri per pianificare la sicurezza e la conformità, connettilo con Crittografia per i dettagli di implementazione in Crittografia Conformità per i dettagli di implementazione in Compliance, Capgo Scansionatore di Sicurezza per il flusso di lavoro del prodotto in Capgo Scansionatore di Sicurezza, Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di Trust per il flusso di lavoro del prodotto in Capgo Centro di Trust.