역할 매핑 승인

POST /v1/connections/{connection_id}/role-mappings/{mapping_id}:approve · 권한 connections:write 및 roles:write

매핑이 생성된 뒤 역할이 권한 있는 역할이 된 매핑을 승인합니다. 승인 후 로그인은 역할을 다시 부여합니다. connections:write에 더해 roles:write가 필요합니다. 권한 없는 역할에 대한 매핑은 승인이 필요 없으며(409 conflict), 이미 승인된 매핑을 승인해도 아무것도 바뀌지 않습니다. 쓰기 작업은 role_mapping.approved로 감사됩니다.

요청

필드 유형 필수 설명
connection_id path 예 엔터프라이즈 연결 ID (conn_…).
mapping_id path 예 역할 매핑 ID (rmp_…).

요청 본문이 없습니다.

응답

승인된 매핑과 함께 200 OK.

{
  "id": "rmp_01j9xw0x4y5z9a1b3c5d7e9f1h",
  "connection_id": "conn_01j9xp6q0r1s5t7v9w1x3y5z7b",
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "external_group_key": "cn=engineering,ou=groups,dc=example,dc=com",
  "role_id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
  "role_privileged": true,
  "approved_at": "2026-10-12T09:31:00.123456Z",
  "created_at": "2026-10-12T09:31:00.123456Z"
}

오류

HTTP code 발생 시점
404 not_found 이 연결에 매핑이 없습니다.
403 privileged_role_mapping_forbidden 자격 증명에 roles:write가 없습니다.
409 conflict 매핑된 역할이 권한 있는 역할이 아니므로 승인할 것이 없습니다.
401 unauthenticated 자격 증명이 없거나 잘못되었거나 취소되었습니다.
403 insufficient_permissions 자격 증명에 필요한 권한이 없습니다.
429 rate_limited 요청 한도를 초과했습니다. Retry-After 기간 후에 다시 시도하십시오.
503 service_unavailable 종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 후에 다시 시도하십시오.

예시

curl -i -X POST "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/role-mappings/rmp_01j9xw0x4y5z9a1b3c5d7e9f1h:approve" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"