매핑 규칙 삭제¶
GET /api/v1/sso_mapping/field/{fdmp_uuid}/delete
개요¶
현재 워크스페이스의 SSO 속성 매핑 하나를 삭제합니다.
호출 전 및 사용 단계¶
이 그룹은 특정 SSO 제공업체의 로그인 attributes를 현재 워크스페이스 역할에 매핑하며, 배포 플랜 LDAP/OIDC의 custom_login_mapping 및 시스템 매핑과는 다릅니다. 규칙을 생성해도 매핑이 자동으로 활성화되지는 않습니다. 해당 SSO 설정에서 isOpenSAMLMapping을 활성화해야 하며(이 그룹에서는 set_disable), SSO 설정 자체도 활성화되어 있어야 합니다.
속성 이름 매칭은 소문자로 비교하며, 값은 정규식/포함 매칭이 아닙니다. 문자열 배열은 값을 하나씩 매칭하고, 배열이 아닌 객체/숫자/null 등은 먼저 json.dumps로 문자열로 변환합니다. 배열 요소는 일괄적으로 문자열로 변환되지 않으므로, 신원 소스에서 안정적인 문자열 속성과 문자열 배열을 우선 사용하는 것이 좋습니다. 여러 역할이 매칭되면 합집합을 사용합니다. SSO 매핑을 활성화한 뒤 규칙이 없거나 매칭되는 항목이 없으면 해당 계정의 이 워크스페이스 진입을 차단할 수 있으며, 이후 로그인/전환 시 기존 연결을 삭제합니다. 기본 역할을 단순히 추가하는 방식이 아닙니다. 저장 후 워크스페이스 및 멤버 캐시가 비동기로 새로고침되므로 기존 SSO 세션의 이후 접근에 영향을 줄 수 있고, 다음 로그인 시에만 적용된다고 보장할 수 없습니다.
기존 진입점은 실제로 GET이지만 삭제 부작용이 있으므로 자동 프리페치/활성 확인/무작위 재시도를 수행하지 않습니다. 해당 매핑만 소프트 삭제하며 역할/제공업체는 삭제하지 않고, isOpenSAMLMapping도 자동으로 끄지 않습니다. 만약 해당 제공업체의 매칭 규칙을 모두 삭제하면, 매핑이 활성화된 SSO 계정은 이후 접근하지 못할 수 있습니다. 삭제 전 감사 과정에서 이전 역할을 해석하며, 역할 기록이 없어도 NotFoundRole이 발생할 수 있습니다. 제출 후 캐시는 비동기로 새로고침되므로, 오류가 발생하면 먼저 목록에서 이미 삭제되었는지 확인하세요.
경로 파라미터¶
| 파라미터명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| fdmp_uuid | string | Y | non-sso_ 제공업체 UUID 또는 lgmp_ 사용자 정의 매핑입니다. 예시: fdmp_example획득 또는 입력 방법: 이 워크스페이스 매핑 목록에서 삭제할 fdmp_ UUID를 가져옵니다. |
요청 헤더¶
| 파라미터명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/sso_mapping/field/fdmp_example/delete' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| content | boolean | 삭제 성공 시 true이며, 존재하지 않는 경우 멱등적 성공을 보장하지 않습니다. |
{
"code": 200,
"content": true,
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하세요.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 404 | ft.SamlMappingNoExists | fdmp_uuid가 이 워크스페이스에 삭제되지 않은 매핑 기록이 없음 | 지정된 Saml Mapping을 찾을 수 없습니다 | 이 워크스페이스 매핑 목록에서 fdmp_ UUID를 다시 가져오며, non-sso_ 또는 lgmp_ 입니다. |
| 404 | ft.NotFoundRole | 입력한 역할 또는 이전 매핑 대상 집합에 이 워크스페이스에서 볼 수 있는 역할 기록이 전혀 없음([] 포함). 수정/삭제 감사에서도 발생할 수 있음 | 지정된 역할을 찾을 수 없거나 역할이 이미 삭제됨 | 역할 목록에서 현재 입력/이전 대상을 확인하고, 빈 집합을 비우기 성공으로 간주하지 마세요. 과거의 잘못된 규칙은 관리자가 수정한 후 처리하세요. |
| 500 | ft.InternalServerError | 저장된 JSON 형태, 데이터베이스 또는 제출 후 작업 디스패치에서 잡히지 않은 예외가 발생함 | 내부 오류 | 데이터베이스는 이미 커밋되었는데 캐시 작업 디스패치가 실패했을 수 있으므로, 먼저 목록에서 규칙/SSO 스위치를 다시 읽은 후 처리하고 traceId를 보존하세요. |