Membri

I membri dell'organizzazione sono gli utenti che hanno accesso alla tua Capgo organizzazione. Ogni membro ha un ruolo specifico che determina le sue 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

• letturaPuò visualizzare le risorse ma non può apportare modifiche
• uploadPuò caricare nuovi bundle e visualizzare le risorse
• writePuò modificare le risorse e caricare bundle
• adminPuò gestire le impostazioni e i membri dell'organizzazione
• super_adminHa il controllo completo sull'organizzazione

Invita Ruoli

• invita_readInvito in attesa di accesso di lettura
• invita_uploadInvito in attesa di accesso di upload
• invita_scritturaInvito in attesa di accesso di scrittura
• invita_amministrazioneInvito in attesa di accesso amministrativo
• invita_super_amministrazionePratiche Migliori

Sottosezione intitolata “Pratiche Migliori”

1. Invito in attesa di accesso super amministrativo: Segui il principio di minima autorità quando assegni ruoli
2. Verifiche regolari: Revisiona periodicamente l'accesso dei membri e elimina gli account non utilizzati
3. Assunzione: Ha un processo chiaro per aggiungere nuovi membri e assegnare ruoli
4. Disassunzione: Elimina prontamente 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.

Richiesta del corpo

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'e-mail di invito. Il loro ruolo sarà prefissato con “_invito” fino a quando non accettano l'invito.
• The utente deve già avere un account Capgo prima di poter essere invitato. Se non hanno un account, dovrebbero 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";
}

Esempio di richiesta

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

Esempio di risposta

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

Elimina

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

Elimina 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 errori 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"
}

Utilizzo comune

1. Espansione della squadra: Aggiungere nuovi membri della squadra con ruoli appropriati
2. Controllo degli accessi: Gestire i permessi dei membri in base ai cambiamenti delle responsabilità
3. Revisione di sicurezza: Recensire periodicamente la lista dei membri e dei ruoli
4. Ristrutturazione della squadra: Aggiornare i ruoli durante i cambiamenti organizzativi

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 Conformità, Capgo Scanner di Sicurezza per il flusso di lavoro del prodotto in Capgo Scanner 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.