콘텐츠로 이동

SSO 구성 삭제(레거시 호환 API)



GET /api/v1/sso/saml_delete/{sso_uuid}

개요

공급자 구성 및 현재 워크스페이스 연결을 삭제합니다.

호출 전 및 사용 단계

이 API는 레거시 주소 호환 인터페이스이며 현재 소스 코드에 여전히 실제 등록되어 있습니다. 과거 “2026-05-31 지원 종료” 주석은 현재 요청이 금지되었음을 의미하지 않습니다. 신규 연동에서는 SSO 구성 삭제를 우선 사용하십시오. 레거시 경로는 동일한 컨트롤러/요청 필드/응답을 사용하며, saml 접두사 때문에 OIDC가 제외되지는 않습니다.

레거시 인터페이스는 실제로 GET이지만 삭제 부작용이 있으므로 명확히 삭제할 때만 호출하고, 자동으로 미리 가져오기/상태 확인하거나 무작정 재시도하지 마십시오. 먼저 구성을 백업하고 현재 관리자에게 다른 사용 가능한 로그인 경로가 여전히 있는지 확인하십시오. 공급자 및 연결된 역할 매핑을 소프트 삭제하고 이메일 허용 목록 정리를 시도합니다. IdP 측 클라이언트/계정을 삭제하지 않으며, 이는 원격 구성이 철회되었음을 의미하지 않습니다.

해당 공급자의 신원 다이제스트로 계정을 조회한 다음 현재 워크스페이스에서 여러 배치로 나누어 제거합니다. 여기에는 멤버 관계/역할/멤버 그룹, 활성 createdWay=user 개인 Key, 워크스페이스 세션 Token, 멤버 캐시/알림 정책 캐시 및 채널 구독의 공유 정리가 포함됩니다. 사용자 계정 자체 및 기타 워크스페이스 관계는 이로 인해 전역 삭제되지 않으며, Key 비활성화 이력도 이번에 모두 정리되는 것과 동일하지 않습니다. 연결된 계정이 현재 Owner인 경우 공유 정리에서 제거가 차단됩니다.

구성, 멤버의 배치별 커밋, Key/캐시/비동기 작업은 하나의 원자적 작업이 아닙니다. 실패 시 일부 구성 또는 멤버 관계가 이미 커밋되었을 수 있으므로 먼저 구성 및 멤버의 현재 상태를 확인하고 곧바로 재생성하지 마십시오. 레거시 빈 idpMd5 분기는 멤버 연결 해제 및 캐시 작업을 건너뛰지만, 컨트롤러 컨텍스트 종료 시에도 삭제된 것으로 커밋될 수 있으므로 실행되지 않았다고 이해해서는 안 됩니다. 허용 목록의 레거시 데이터 및 조회 호환성 문제로 인해 모든 잔여 항목이 제거되었다고 보장할 수 없으므로 마이그레이션 후 실제 로그인 발견 항목을 재검토해야 합니다. needNotify=false는 이메일만 억제하며, 이메일 발송 실패는 기록되고 삭제를 롤백하지 않습니다.

경로 매개변수

매개변수 이름 유형 필수 설명
sso_uuid string Y 현재 공급자 UUID이며 fdmp_ 매핑, IdP 다이제스트 또는 클라이언트 ID가 아닙니다.
예: sso_example
가져오기 또는 입력 방법: 이 워크스페이스의 SSO 목록 content[].uuid에서 삭제되지 않은 구성을 가져옵니다.

요청 헤더

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

Query 요청 매개변수

매개변수 이름 유형 필수 설명
needNotify string 선택적 true/false 문자열이며 기본값은 true입니다. false는 이메일만 억제하며 삭제/멤버 정리/캐시/감사는 계속 수행됩니다.
null 허용: False
선택 가능 값: ['true', 'false']
예: false
가져오기 또는 입력 방법: 워크스페이스 Owner/관리자에게 구성 삭제 알림을 보낼지 여부입니다.

요청 예시

curl --get 'https://openapi.guance.com/api/v1/sso/saml_delete/sso_example' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-urlencode needNotify=false

응답

HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.

필드 유형 설명
content.name string 처리된 공급자 표시 이름이며, 이름이 비어 있으면 빈 문자열일 수 있습니다.
content.declaration object 공용 선언.
{
  "code": 200,
  "content": {
    "name": "ExampleIdP",
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반함 매개변수 파싱 실패 매개변수 위치, 필드 이름, 유형 및 값을 확인하십시오.
406 ft.NotFoundSAML UUID가 현재 워크스페이스의 삭제되지 않은 SSO 구성에 속하지 않음 sso 구성을 찾을 수 없음 SSO 목록에서 sso_ UUID를 다시 가져오고 fdmp_ 매핑 또는 idpMd5를 사용하지 마십시오.
400 ft.InvalidActionForbiddenRemovalOwner 신원 다이제스트에 연결된 계정 중 현재 워크스페이스 Owner가 있어 멤버 제거 보호에 의해 거부됨 유효하지 않은 작업, 소유자를 제거할 수 없음 먼저 Owner 소속 및 실제 로그인 방식을 확인하고, 권한이 있는 관리자가 적절히 조정한 후 삭제하십시오.
400 ft.AgentMemberCanNotDelete 연결된 네임스페이스 대상에 공유 멤버 정리에서 삭제가 금지된 에이전트 멤버가 포함됨 agent 출처 멤버는 삭제할 수 없음 계정 출처 및 이전 연결을 확인하고 관리자에게 문의하십시오. 일부는 이미 배치별로 커밋되었을 수 있습니다.
500 ft.InternalServerError 데이터베이스/연결 정리 또는 커밋 후 워크스페이스/멤버 캐시 작업 디스패치 실패 내부 오류 먼저 get/list로 status와 연결을 확인하십시오. 멤버 정리가 이미 배치별로 커밋되었을 수 있습니다. traceId를 보존하고, 오류를 구성이 전혀 변경되지 않은 것으로 간주해서는 안 됩니다.

문서 평가

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