콘텐츠로 이동

매핑 설정 삭제



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

개요

지정한 시스템 로그인 매핑 규칙을 소프트 삭제합니다.

호출 전 및 사용 단계

먼저 시스템 로그인 매핑 목록에서 uuid, 소스 속성 및 대상 워크스페이스를 확인합니다. 이 API에는 Body가 없으며, 활성 시스템 규칙 한 건만 삭제합니다. 반복 삭제하거나 워크스페이스 사용자 지정 규칙 UUID를 전달하면 404를 반환합니다. 설정 삭제는 이미 부여된 사용자 역할이나 기존 세션을 즉시 철회하는 것을 의미하지 않습니다. 이후 관련 로그인에서 권한이 어떻게 변경되는지는 현재 모드에 따라 달라집니다. GlobalValid는 일치하지 않는 직접 관계를 정리할 수 있고, Append는 일반적으로 기존 시스템 부여 관계를 유지합니다. 워크스페이스 사용자 지정 매핑이 활성화된 경우 해당 우선 규칙의 제어도 받습니다. 즉시 권한을 철회해야 할 경우 멤버/역할 및 세션 관리 절차를 통해 확인하여 처리합니다.

경로 매개변수

매개변수 이름 유형 필수 설명
lgmp_uuid string Y 활성 시스템 매핑 UUID이며, 워크스페이스 UUID가 아닙니다.
예: lgmp_example001
획득 또는 입력 방법: 시스템 로그인 매핑 목록의 content.data[].uuid에서 가져옵니다.

요청 헤더

매개변수 이름 유형 필수 설명
X-Df-SVersion string 원본 경로 및 요청 본문 서명 버전입니다. 생략한 뒤 이 페이지의 알고리즘을 계속 사용할 수는 없습니다.
예: v20240417
획득 또는 입력 방법: 이 페이지의 예제는 이 고정 버전을 사용하며 예제 서명 알고리즘과 함께 사용됩니다.
X-Df-Access-Key string Y 읽기 API에는 r 또는 w 자격 증명을 사용할 수 있으며, 쓰기 API에는 w 자격 증명이 필요합니다.
예: <external-access-key>
획득 또는 입력 방법: 사이트 관리자가 할당한 External API AK를 사용하며, 워크스페이스 OpenAPI Key는 사용할 수 없습니다.
X-Df-Nonce string Y 임시 일련번호입니다. 실패 후 재전송할 때도 새 값을 생성하고 서명을 다시 계산합니다.
예: 97d275ee9f774315a7885ba7347acbd9
획득 또는 입력 방법: 요청마다 uuid.uuid4().hex를 다시 생성합니다.
X-Df-Signature string Y 대문자 메서드, nonce, 원본 전체 경로, timestamp 및 원본 UTF-8 요청 본문을 공백으로 연결한 뒤 HMAC-SHA256을 수행하고 hex 다이제스트를 구합니다.
예: <hmac-sha256-hex>
획득 또는 입력 방법: External API 서명 인증에 따라 함께 제공되는 SK로 계산하며, 전체 실행 가능한 템플릿은 아래를 참조하십시오.
X-Df-Timestamp string Y 사이트에 구성된 서명 유효 시간 범위 내에 있어야 하며, 예제 시간을 재사용할 수 없습니다.
예: 1785427200
획득 또는 입력 방법: 전송 시 str(int(time.time()))를 사용하여 현재 Unix 초 문자열을 생성합니다.

매개변수 추가 설명

인증 방식은 External API 서명 인증을 참조하십시오. 이 모듈은 사이트 시스템 로그인 매핑(isSystem=1)을 관리하며, OIDC/LDAP 등 공유 로그인 매핑 경로를 사용하는 타사 로그인에서 사용됩니다. 워크스페이스 사용자 지정 매핑 또는 독립적인 SAML 설정 인터페이스가 아닙니다. 설정 저장은 모든 기존 사용자 권한을 즉시 일괄 재계산하지 않으며, 이후 관련 로그인 시에만 모드에 따라 처리합니다.

시스템 매핑이 활성화되어 있고 대상 워크스페이스의 사용자 지정 매핑이 비활성화된 경우: ValidOnFirstLogin은 이력상 직접 워크스페이스 연결이 전혀 없는 계정에만 시스템 규칙을 적용합니다(이력에는 삭제된 연결도 포함). 이는 이번에 계정이 새로 생성되는지만 판단하는 것과 동일하지 않습니다. GlobalValid는 관련 로그인 시마다 규칙에 따라 직접 역할을 교체하며, 일치하지 않으면 직접 멤버/역할 관계를 제거할 수 있습니다. Append는 일치하는 시스템 역할만 추가하며, 일치하지 않아도 기존 직접 관계를 정리하지 않습니다. 워크스페이스에서 사용자 지정 매핑을 활성화한 경우 해당 워크스페이스는 사용자 지정 규칙에 따라 교체/미일치 정리를 우선 수행하며, 시스템 Append 또는 최초 모드의 유지 의미를 적용할 수 없습니다. 시스템 스위치를 비활성화해도 워크스페이스 사용자 지정 규칙이 함께 비활성화되지는 않습니다. 기존 직접 Owner 역할은 매칭 처리 중 유지되며, 이 모듈을 통해 Owner를 새로 부여하지 않습니다.

요청 예시

import hashlib
import hmac
import json
import time
import uuid
from urllib.parse import urlencode
from urllib.request import Request, urlopen

# 대상 사이트 주소 및 관리자가 할당한 External API AK/SK로 바꿉니다.
server = "https://external-api.guance.com"
access_key = "<external-access-key>"
secret_key = "<external-secret-key>"
method = 'POST'
path = '/api/v1/login_mapping/field/lgmp_example001/delete'
query = {}
data = None
full_path = path + ("?" + urlencode(query) if query else "")
body = "" if data is None else json.dumps(data, ensure_ascii=False, separators=(",", ":"))
timestamp = str(int(time.time()))
nonce = uuid.uuid4().hex
string_to_sign = " ".join([method, nonce, full_path, timestamp, body])
signature = hmac.new(secret_key.encode("utf-8"), string_to_sign.encode("utf-8"), hashlib.sha256).hexdigest()
headers = {
    "X-Df-Access-Key": access_key,
    "X-Df-Timestamp": timestamp,
    "X-Df-Nonce": nonce,
    "X-Df-Signature": signature,
    "X-Df-SVersion": "v20240417",
}
if data is not None:
    headers["Content-Type"] = "application/json"
request = Request(server + full_path, data=None if data is None else body.encode("utf-8"), headers=headers, method=method)
with urlopen(request) as result:
    print(result.read().decode("utf-8"))

응답

HTTP 200, application/json 공통 래퍼를 사용합니다. External은 declaration을 자동 주입하지 않으며, 목록 페이지네이션은 content.pageInfo에 있습니다.

필드 유형 설명
content boolean 설정 삭제가 완료되면 true이며, 영향을 받은 사용자 목록을 반환하지 않고 사용자 권한이 즉시 재계산되었음을 의미하지도 않습니다.
{
  "code": 200,
  "content": true,
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

확인된 규칙 및 요청 오류는 표에 나열되어 있습니다. 일반 데이터베이스/캐시/감사 예외는 최종적으로 500 ft.InternalServerError가 됩니다. 설정이 이미 커밋된 후 후속 오류가 발생할 수 있으므로, 현재 상태를 먼저 읽은 후 재시도하십시오.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반했습니다. 매개변수 구문 분석 실패 매개변수 위치, 필드 이름, 유형 및 값을 확인하십시오.
404 ft.LoginMappingNoExists UUID가 존재하지 않거나, 삭제되었거나, 활성 status=0이 아니거나, 시스템 매핑이 아닙니다. 지정한 Login Mapping을 찾을 수 없습니다. 이 모듈의 시스템 매핑 목록에서 유효한 uuid를 다시 선택하고, 워크스페이스 사용자 지정 규칙 UUID를 사용하지 마십시오.
500 ft.InternalServerError 데이터베이스, 사이트 설정 캐시, 감사 또는 처리되지 않은 이력 데이터 예외입니다. 내부 오류 traceId를 보존하고, 먼저 규칙 또는 스위치를 읽어 현재 상태를 확인하십시오. 데이터베이스와 캐시/감사는 동일한 트랜잭션이 아니므로 오류가 완전히 저장되지 않았음을 증명하지는 않습니다.

문서 평가

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