콘텐츠로 이동

SSO 사용자 지정 매핑 규칙 삭제



POST /api/v1/login_mapping/field/{lgmp_uuid}/delete

개요

현재 워크스페이스의 사용자 지정 로그인 매핑 규칙 하나를 삭제합니다.

호출 전 및 사용 단계

이 그룹은 현재 워크스페이스의 isSystem=false인 배포 플랜 사용자 지정 로그인 속성 매핑을 관리하며, ssoUUID로 ID 공급자에 바인딩된 SAML 매핑 및 External/Inner 시스템 매핑과는 다릅니다. 실제 적용하려면 워크스페이스에서 isOpenCustomMappingRule을 활성화해야 합니다. 사용자 지정 매핑에서 스위치를 구성하고 로그인 정책을 확인할 수 있습니다. 저장/삭제는 규칙만 변경하며 기존 멤버의 역할을 즉시 변경하지 않고 기존 세션을 취소하지 않습니다. 이후 LDAP/OIDC 공유 로그인 흐름은 실제 userinfo에 따라 다시 매칭합니다.

매칭은 userinfo 최상위 속성을 사용합니다. 배열은 각 요소를 str(value)로 비교하고, 그 외 값은 Python 문자열 표현으로 비교합니다. 필드와 값에는 데이터베이스 등가 의미론을 사용하며(대소문자/정렬 규칙은 배포 데이터베이스에 따라 결정됨), 정규식/포함 또는 중첩 경로 추출은 수행하지 않습니다. ID 소스의 안정적인 문자열만 사용하는 것이 좋습니다. 일치하는 여러 규칙의 역할은 합집합으로 가져온 후 사용 가능한 역할을 필터링합니다. 워크스페이스 사용자 지정 스위치가 켜져 있으면 시스템 규칙보다 우선합니다. 일치 항목이 있으면 일반적으로 역할을 재설정하고, 일치 항목이 없으면 기존 연결이 지워질 수 있습니다. 기존 Owner 역할에는 보호 로직이 있습니다. 실제 권한은 먼저 전용 테스트 ID로 검증해야 하며, 이번 HTTP 성공만으로 다음 로그인 시 역할이 올바르다고 판단할 수 없습니다.

매핑 설정을 소프트 삭제하며 대상 역할 또는 계정을 삭제하지 않고, 멤버가 이미 보유한 역할/세션을 즉시 취소하지 않습니다. 이후 로그인 시 사용자 지정 스위치가 활성화되어 있고 일치 항목이 없으면 기존 역할 관계가 지워질 수 있으므로, 삭제는 ‘향후 로그인 권한을 그대로 유지’하는 것이 아닙니다. 존재하지 않거나 다른 워크스페이스에 속하거나 system이거나 비활성 상태인 레코드는 LoginMappingNoExists를 반환합니다. 삭제 전 감사에서는 이전 대상 역할을 해석하며, 이전 집합이 비어 있거나 표시 가능한 레코드가 없으면 404가 발생하고 삭제가 완료되지 않을 수 있습니다. 타임아웃/오류 후에는 먼저 목록에서 최종 레코드 상태를 확인한 뒤 재시도 여부를 결정하세요.

라우트 파라미터

파라미터 이름 유형 필수 설명
lgmp_uuid string Y 단건 삭제는 활성 status=0 객체만 조작합니다.
예: lgmp_example
획득 또는 입력 방법: 현재 워크스페이스의 사용자 지정 매핑 목록에서 lgmp_ UUID를 가져옵니다.

요청 헤더

파라미터 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/login_mapping/field/lgmp_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.NotFoundRole 대상/기존 매핑 역할 집합에 일치하는 표시 가능한 역할 레코드가 없습니다(빈 배열 [] 포함). 단건 삭제 또는 일괄 삭제 시 감사에서 이전 역할을 해석할 때도 발생할 수 있습니다. 지정된 역할을 찾을 수 없거나 역할이 삭제되었습니다. 먼저 현재 워크스페이스의 역할 목록과 매핑 목록에서 확인하세요. 알 수 없는 역할이 일부 섞여 있으면 필터링됩니다. 과거의 빈 집합/일치하지 않는 집합은 삭제 가능하다고 바로 가정할 수 없으며, 관리자가 수정한 후 처리해야 합니다.
500 ft.InternalServerError 매핑/역할/데이터베이스 저장 또는 데이터 형식 지정 중 처리되지 않은 예외가 발생했습니다. 내부 오류 먼저 목록에서 규칙이 저장되었는지와 최종 targetValues를 확인한 뒤 특정 필드에 대해 처리하고 traceId를 보존하세요.
404 ft.LoginMappingNoExists 단일 UUID가 현재 워크스페이스의 isSystem=false이고 status=0인 매핑에 속하지 않습니다. 지정된 Login Mapping을 찾을 수 없습니다. 현재 워크스페이스 목록에서 lgmp_ UUID를 다시 가져오세요. 시스템 규칙 또는 비활성 레코드는 이 단일 항목 진입점을 통해 조작할 수 없습니다.

문서 평가

이 페이지가 도움이 되었나요?