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를 보존하고, 오류를 구성이 전혀 변경되지 않은 것으로 간주해서는 안 됩니다. |