매핑 규칙 삭제(이전 호환 API)¶
GET /api/v1/saml/mapping/field/{fdmp_uuid}/delete
개요¶
현재 워크스페이스의 SSO 속성 매핑 하나를 삭제합니다.
호출 전 및 사용 단계¶
이 API는 이전 주소 호환 인터페이스이며, 현재 소스 코드에 여전히 실제로 등록되어 있습니다. 과거 “2026-05-31 중단” 주석은 현재 요청이 금지되었음을 의미하지 않습니다. 신규 연동 시에는 매핑 규칙 삭제를 우선 사용하십시오. 이전 경로는 동일한 컨트롤러/요청 필드/응답을 유지하며, saml 접두사 때문에 OIDC를 제외하지 않습니다.
이 그룹은 특정 SSO 공급자의 로그인 속성을 현재 워크스페이스 역할에 매핑하며, 배포 플랜 LDAP/OIDC의 custom_login_mapping 및 시스템 매핑과 다릅니다. 규칙 생성만으로 매핑이 자동 활성화되지는 않습니다. 해당 SSO 구성에서 isOpenSAMLMapping(이 그룹의 set_disable)을 활성화해야 하며, SSO 구성 자체도 활성화되어 있어야 합니다.
속성 이름 매칭은 소문자로 비교하며, 값은 정규식/포함 매칭이 아닙니다. 문자열 배열은 각 값을 개별적으로 매칭합니다. 배열이 아닌 객체/숫자/null 등은 먼저 json.dumps로 문자열로 변환하지만, 배열 요소는 일괄적으로 문자열로 변환하지 않습니다. 따라서 ID 소스에서 안정적인 문자열 속성과 문자열 배열을 우선 사용하십시오. 일치한 역할이 여러 개이면 합집합을 사용합니다. SSO 매핑이 활성화된 후 규칙이 없거나 일치하는 규칙이 없으면 계정이 이 워크스페이스에 들어오는 것을 차단할 수 있으며, 이후 로그인/전환 시 기존 연결을 삭제합니다. 단순히 기본 역할을 추가하는 것이 아닙니다. 기록 후 워크스페이스와 멤버 캐시를 비동기적으로 새로 고치므로, 기존 SSO 세션의 후속 액세스에 영향을 줄 수 있으며 다음 로그인에만 적용된다고 보장할 수 없습니다.
이전 진입점은 실제로 GET이지만 삭제 부작용이 있으므로 자동 프리페치/헬스 체크/무분별한 재시도를 수행하지 않습니다. 해당 매핑만 소프트 삭제하며 역할/공급자는 삭제하지 않고, isOpenSAMLMapping도 자동으로 끄지 않습니다. 해당 공급자의 일치 규칙을 모두 삭제하면 매핑이 활성화된 SSO 계정이 이후 액세스하지 못할 수 있습니다. 삭제 전 감사에서 기존 역할을 파싱하며, 역할 기록이 없어도 NotFoundRole이 발생할 수 있습니다. 제출 후 캐시를 비동기적으로 새로 고치므로, 오류가 발생하면 먼저 목록에서 삭제 여부를 확인하십시오.
경로 파라미터¶
| 파라미터 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| fdmp_uuid | string | Y | 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/saml/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를 다시 가져오십시오. sso_ 또는 lgmp_가 아닌 값이어야 합니다. |
| 404 | ft.NotFoundRole | 입력 역할 또는 기존 매핑 대상 집합에 이 워크스페이스에서 볼 수 있는 역할 기록이 전혀 없음([] 포함). 수정/삭제 감사에서도 발생할 수 있음 | 지정된 역할을 찾을 수 없거나 역할이 이미 삭제됨 | 역할 목록에서 현재 입력/기존 대상을 확인하고, 빈 집합을 초기화 성공으로 간주하지 마십시오. 과거의 잘못된 규칙은 관리자가 수정한 후 처리하십시오. |
| 500 | ft.InternalServerError | 저장된 JSON 형상, 데이터베이스 또는 제출 후 작업 디스패치에서 처리되지 않은 예외 발생 | 내부 오류 | 데이터베이스는 이미 커밋되었지만 캐시 작업 디스패치가 실패했을 수 있으므로, 먼저 목록에서 규칙/SSO 스위치를 다시 읽은 후 처리하고 traceId를 보존하십시오. |