Associa un gruppo di directory a un ruolo

POST /v1/directories/{directory_id}/role-mappings · permesso directories:write

Associa un gruppo di una directory SCIM (directory_group_id) a un ruolo; i membri del gruppo ricevono il ruolo nell'organizzazione della directory. Il gruppo deve appartenere a questa directory. Il ruolo deve essere un ruolo dell'ambiente o un ruolo dell'organizzazione della directory. L'associazione a un ruolo privilegiato richiede inoltre roles:write, e l'associazione viene creata già approvata. Una directory in fase di eliminazione non accetta nuove associazioni. Al massimo 500 associazioni per directory. La scrittura viene registrata nel registro di controllo come role_mapping.created.

Richiesta

Campo Tipo Obbligatorio Descrizione
directory_id path sì ID della directory SCIM (dir_…).
directory_group_id string sì ID del gruppo di directory (dsg_…).
role_id string sì ID del ruolo (rol_…).

Risposta

201 Created con l'associazione.

{
  "id": "rmp_01j9xw0x4y5z9a1b3c5d7e9f1h",
  "directory_id": "dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "directory_group_id": "dsg_01j9xn3p5q7r9s1t3v5w7x9y1a",
  "role_id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
  "role_privileged": false,
  "approved_at": null,
  "created_at": "2026-10-13T09:31:00.123456Z"
}

Errori

HTTP code Quando
404 not_found La directory non esiste in questo ambiente.
403 privileged_role_mapping_forbidden Il ruolo è privilegiato e la credenziale non ha roles:write.
409 conflict Il gruppo è già associato a questa directory, oppure la directory è in fase di eliminazione.
409 role_mapping_limit_reached La directory ha già 500 associazioni.
422 validation_failed directory_group_id o role_id mancano o non sono validi, il gruppo non appartiene a questa directory (unknown_group), oppure il ruolo è fuori dall'ambito della directory.
401 unauthenticated La credenziale è assente, non valida o revocata.
403 insufficient_permissions La credenziale non ha il permesso richiesto.
429 rate_limited È stato superato il limite di frequenza; riprova dopo il periodo indicato da Retry-After.
503 service_unavailable Non è stato possibile verificare il record della directory oppure una dipendenza non è temporaneamente disponibile; riprova dopo il periodo indicato da Retry-After.

Esempio

curl -i -X POST "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/role-mappings" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"directory_group_id":"dsg_01j9xn3p5q7r9s1t3v5w7x9y1a","role_id":"rol_01j9xr7s1t2w6x8y0z2a4b6c8e"}'