콘텐츠로 이동

크로스 사이트 권한 부여 meta 생성



POST /api/v1/workspace_data/cross_site_grant/meta/create

개요

데이터 권한 부여자에서 pending 레코드 및 전달 가능한 서명 권한 부여 패키지를 생성합니다.

호출 전 준비 및 사용 단계

dataRightsManage.workspaceConfigManage 권한이 있는 API Key를 사용하며, 워크스페이스는 Key로 결정됩니다. 권한 부여자는 데이터를 제공하는 워크스페이스이고, 권한 부여 대상자는 데이터를 조회하는 대상 워크스페이스이며, 두 워크스페이스는 반드시 서로 달라야 합니다. 배포 플랜은 먼저 배포 플랜 크로스 사이트 권한 부여 사용 안내에 따라 버전, 현재 사이트 신원, 인증서 및 허용된 사이트 간 관계 설정을 완료해야 합니다. 개인 키는 관리자가 서버 측에 보관하며 요청/권한 부여 패키지에 포함하지 않습니다.

권한 부여자 사이트에서 호출하며, 대상 UUID, 데이터 유형, 로그 인덱스를 명시적으로 선택합니다. 기본값/빈 type 및 indexes는 전체 권한 부여로 확장될 수 있으므로, 필요한 최소 범위를 명확히 지정할 것을 권장합니다. HTTP 200은 JSON 객체와 권장 fileName을 반환하며 파일 다운로드가 아닙니다. success를 확인한 후 content.meta를 별도의 JSON 파일로 저장하고, 안전하게 권한 부여 대상자에게 전달하여 meta 가져오기에 따라 가져오도록 합니다. 예시의 공개 키, JWS 및 시간은 예시일 뿐이며 그대로 재사용할 수 없습니다.

생성은 소스 측 pending 레코드만 저장하고 대상 사이트에 능동적으로 접근하지 않으며, 권한 부여가 이미 적용되었음을 의미하지도 않습니다. 만료 기본값은 1800초이며 사이트 설정으로 재정의할 수 있고, expireAt을 기준으로 합니다. 동일한 소스/대상에 pending 또는 active 레코드가 이미 존재하면 거부될 수 있으며, 범위를 변경하거나 패키지가 만료되었다고 해서 자동으로 새 패키지가 생성되지는 않습니다. 먼저 권한 부여 레코드 목록에서 확인하고 권한 부여 절차에 따라 이전 레코드를 취소/삭제한 후 다시 생성하십시오. 실패 또는 타임아웃 후에는 먼저 레코드를 확인하고, 무작정 재시도하여 생성하지 마십시오. 이후 범위 수정 및 취소는 계속 권한 부여 레코드 관리를 사용합니다.

요청 헤더

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

Body 요청 파라미터

파라미터명 유형 필수 설명
type[*] string 하나의 데이터 카테고리이며 *를 포함하면 전체를 의미합니다. 사용 가능한 카테고리에는 object/custom_object/keyevent/security/network/profiling 등이 있으며, 대상 쿼리 기능을 기준으로 합니다.
예시: logging
가져오기 또는 입력 방법: 필요한 데이터 카테고리에서 선택하고 와일드카드를 잘못 사용하지 마십시오.
indexes[*] string 하나의 로그 인덱스 이름이며, 정규화 시 문자열로 변환되고 앞뒤 공백이 제거됩니다.
예시: default
가져오기 또는 입력 방법: 로그 인덱스 목록에서 이름을 가져옵니다.
conditions.metric array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
예시: [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]
가져오기 또는 입력 방법: metric 데이터에 이미 있는 필드와 태그에 따라 구성합니다.
conditions.metric[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
예시: {"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}
가져오기 또는 입력 방법: 각 항목에 하나의 필드 조건을 입력합니다.
conditions.metric[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: host
가져오기 또는 입력 방법: 권한 부여자의 실제 필드/태그 이름에서 가져옵니다.
conditions.metric[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: in
가져오기 또는 입력 방법: in 또는 not in을 선택합니다.
conditions.metric[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
예시: and
가져오기 또는 입력 방법: 동일 데이터 카테고리 내에서 and 또는 or을 통일하여 사용합니다.
conditions.metric[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
예시: ["host-example"]
가져오기 또는 입력 방법: 필드의 실제 허용/제외 값을 입력합니다.
conditions.metric[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
예시: host-example
가져오기 또는 입력 방법: 해당 필드의 실제 값에서 가져옵니다.
conditions.tracing array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
예시: [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]
가져오기 또는 입력 방법: tracing 데이터에 이미 있는 필드와 태그에 따라 구성합니다.
conditions.tracing[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
예시: {"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}
가져오기 또는 입력 방법: 각 항목에 하나의 필드 조건을 입력합니다.
conditions.tracing[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: host
가져오기 또는 입력 방법: 권한 부여자의 실제 필드/태그 이름에서 가져옵니다.
conditions.tracing[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: in
가져오기 또는 입력 방법: in 또는 not in을 선택합니다.
conditions.tracing[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
예시: and
가져오기 또는 입력 방법: 동일 데이터 카테고리 내에서 and 또는 or을 통일하여 사용합니다.
conditions.tracing[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
예시: ["host-example"]
가져오기 또는 입력 방법: 필드의 실제 허용/제외 값을 입력합니다.
conditions.tracing[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
예시: host-example
가져오기 또는 입력 방법: 해당 필드의 실제 값에서 가져옵니다.
conditions.rum array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
예시: [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]
가져오기 또는 입력 방법: rum 데이터에 이미 있는 필드와 태그에 따라 구성합니다.
conditions.rum[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
예시: {"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}
가져오기 또는 입력 방법: 각 항목에 하나의 필드 조건을 입력합니다.
conditions.rum[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: host
가져오기 또는 입력 방법: 권한 부여자의 실제 필드/태그 이름에서 가져옵니다.
conditions.rum[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: in
가져오기 또는 입력 방법: in 또는 not in을 선택합니다.
conditions.rum[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
예시: and
가져오기 또는 입력 방법: 동일 데이터 카테고리 내에서 and 또는 or을 통일하여 사용합니다.
conditions.rum[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
예시: ["host-example"]
가져오기 또는 입력 방법: 필드의 실제 허용/제외 값을 입력합니다.
conditions.rum[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
예시: host-example
가져오기 또는 입력 방법: 해당 필드의 실제 값에서 가져옵니다.
conditions.lineage array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
예시: [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]
가져오기 또는 입력 방법: lineage 데이터에 이미 있는 필드와 태그에 따라 구성합니다.
conditions.lineage[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
예시: {"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}
가져오기 또는 입력 방법: 각 항목에 하나의 필드 조건을 입력합니다.
conditions.lineage[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: host
가져오기 또는 입력 방법: 권한 부여자의 실제 필드/태그 이름에서 가져옵니다.
conditions.lineage[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: in
가져오기 또는 입력 방법: in 또는 not in을 선택합니다.
conditions.lineage[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
예시: and
가져오기 또는 입력 방법: 동일 데이터 카테고리 내에서 and 또는 or을 통일하여 사용합니다.
conditions.lineage[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
예시: ["host-example"]
가져오기 또는 입력 방법: 필드의 실제 허용/제외 값을 입력합니다.
conditions.lineage[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
예시: host-example
가져오기 또는 입력 방법: 해당 필드의 실제 값에서 가져옵니다.
conditions json 선택적 JSON 객체이며, 생략/{}는 추가 필터가 없음을 의미합니다. metric/tracing/rum/lineage는 각각 설정하며, 다른 카테고리에는 이 네 가지 하위 조건이 적용되지 않습니다. 중첩 형태가 완전히 검증되지 않으므로 각 항목이 객체임을 직접 보장해야 합니다.
허용 null: False
예시: {"metric": [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]}
가져오기 또는 입력 방법: 권한 부여자의 실제 필드 및 허용 값을 기준으로 구성하며, 본 페이지에서 확인된 네 가지 조건만 사용합니다.
indexes array 선택적 배열이며, 생략/빈 배열은 ["*"]로 정규화됩니다. type에 logging 또는 *가 포함된 경우에만 유지되고 그렇지 않으면 []로 비워집니다. *는 모든 로그 인덱스를 의미하므로 신중하게 사용하십시오.
허용 null: False
예시: ["default"]
가져오기 또는 입력 방법: 권한 부여자 로그 인덱스 목록의 name에서 가져오며 인덱스 UUID가 아닙니다.
targetWorkspaceUUID string 조건부 필수이며 workspaceUUID와 최소 하나가 필요합니다. 둘 다 제출되면 이 필드가 우선합니다. 비어 있지 않고 앞뒤 공백이 없으며 wksp_ 접두사를 가지며 중국어가 없어야 하고, 권한 부여자의 현재 워크스페이스와 같을 수 없습니다. 이번 호출에서는 대상에 연결하여 실제 존재 여부를 검증하지 않습니다.
허용 빈 문자열: False
허용 null: False
예시: wksp_target
가져오기 또는 입력 방법: 권한 부여 대상자가 대상 워크스페이스 정보에서 uuid를 가져와 제공하며, 이 필드 사용을 권장합니다.
type array 선택적 배열이며, 생략/null/빈 배열은 모두 ["*"] 즉 전체 카테고리로 정규화되며 권한 부여가 없음을 의미하는 것이 아닙니다! 배열 요소는 문자열로 변환됩니다. 현재 카테고리 열거를 완전히 검증하지 않으므로 대상이 실제 지원하는 카테고리를 사용하십시오.
허용 null: True
예시: ["logging", "metric"]
가져오기 또는 입력 방법: 권한을 부여할 데이터 카테고리를 명시적으로 선택합니다. 예를 들어 logging 로그, metric 메트릭, tracing 트레이스, rum 사용자 방문, lineage 계보입니다.
workspaceUUID string 대상 워크스페이스와 의미가 같으며 우선순위가 targetWorkspaceUUID보다 낮습니다. 본 인터페이스의 소스 워크스페이스를 지정하는 것이 아닙니다.
허용 빈 문자열: False
허용 null: False
예시: wksp_target
가져오기 또는 입력 방법: 이전 클라이언트 호환 필드이며, 새로운 호출에서는 targetWorkspaceUUID만 입력합니다.

파라미터 추가 설명

권한 부여자가 크로스 사이트 권한 부여 meta 파일을 생성합니다. 프런트엔드 또는 호출자는 먼저 권한 부여자 사이트에서 CrossSiteGrantCfg 공개/개인 키 초기화를 완료해야 합니다.

상세 내용은 다음을 참조하십시오: 배포 플랜 크로스 사이트 권한 부여 사용 안내

  • 사용 사례: 사용자가 "크로스 사이트 권한 부여"를 선택한 후 권한 부여자 워크스페이스에서 본 인터페이스를 호출하여 meta를 생성하고, 완전한 meta를 권한 부여 대상자에게 전달하여 가져오도록 합니다.
  • 배포 플랜 서비스는 최소 2026-06-03 릴리스 버전으로 업그레이드해야 새 버전의 사이트 간 권한 부여 방식을 지원합니다.
  • 본 인터페이스는 권한 부여자 pending 레코드만 생성하고 meta를 반환하며, 권한 부여 대상자 사이트에 능동적으로 접근하지 않습니다.
  • 생성된 비즈니스 권한 부여 레코드는 계속 /wksp_share/list로 조회하고, /wksp_share/<uuid>/modify로 권한 부여 범위를 수정하며, /wksp_share/delete로 삭제 또는 취소합니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/workspace_data/cross_site_grant/meta/create' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"targetWorkspaceUUID":"wksp_target","type":["logging"],"indexes":["default"],"conditions":{}}'

응답

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

필드 유형 설명
content.grantUUID string 소스 측 pending 권한 부여 레코드 UUID입니다.
content.status string 본 인터페이스가 성공하면 pending이며, 이후 대상에서 가져오기를 통해 활성화해야 합니다.
content.expireAt integer 패키지 유효 기한(Unix 초)입니다.
content.fileName string 권장 저장 파일 이름이며, 서버에 다운로드 가능한 파일이 생성되었음을 의미하지 않습니다.
content.meta object 완전하게 전달해야 하는 권한 부여 패키지입니다.
content.declaration object 소스 워크스페이스의 공개 선언이며 meta 권한 부여 패키지에 속하지 않습니다.
content.meta.version string 생성된 프로토콜 버전이며 현재 2026-05-27이고 원래 값을 유지합니다.
content.meta.metaUUID string 이번 권한 부여 패키지 식별자이며 이후 교환에 사용됩니다.
content.meta.createdAt integer 생성 시간(Unix 초)입니다.
content.meta.expireAt integer 권한 부여 패키지 만료 시간(Unix 초)이며 이전에 가져와야 합니다.
content.meta.sourceWorkspace object 데이터 권한 부여자 워크스페이스 정보입니다.
content.meta.sourceWorkspace.workspaceUUID string 권한 부여자 워크스페이스 UUID이며 소스 API Key로 결정됩니다.
content.meta.sourceWorkspace.workspaceName string 소스 워크스페이스 이름 스냅샷이며 비어 있을 수 있습니다.
content.meta.targetWorkspaceUUID string 권한 부여 대상자 워크스페이스 UUID이며, 가져오기에 사용한 Key의 워크스페이스와 같아야 합니다.
content.meta.sourceSite object 권한 부여자 사이트 신원 및 접근 주소이며 서버에서 제공하고, 브랜드/도메인을 임의로 입력하거나 교체하지 않습니다.
content.meta.sourceSite.siteCode string 권한 부여자 사이트 코드입니다.
content.meta.sourceSite.regionCode string 권한 부여자 리전 코드이며 패키지 원래 값으로 전달합니다.
content.meta.sourceSite.name string 사이트 표시 이름입니다.
content.meta.sourceSite.issuer string 권한 부여자 서명 신원입니다.
content.meta.sourceSite.baseUrl string 가져오는 측 서버가 능동적으로 요청하는 권한 부여자 API 기본 주소이며, 권한 부여자가 신뢰할 수 있게 제공하고 연결 가능해야 합니다.
content.meta.sourceSite.jwksUri string 권한 부여자 공개 키 자료 주소입니다.
content.meta.sourceSite.kid string 현재 활성 서명 Key 식별자입니다.
content.meta.sourceSite.publicKeys array<object> 서버에서 필터링한 공개 키 집합이며 개인 키를 포함하지 않습니다.
content.meta.sourceSite.publicKeys[*] object 하나의 공개 키 자료입니다.
content.meta.sourceSite.publicKeys[*].kid string 해당 공개 키 식별자입니다.
content.meta.sourceSite.publicKeys[*].publicKey string PEM 공개 키 본문이며 개인 키나 API Key가 아닙니다.
content.meta.grantScope object 정규화된 권한 부여 범위입니다.
content.meta.grantScope.type array<string> 데이터 카테고리 배열입니다.
content.meta.grantScope.type[*] string 하나의 카테고리 또는 *입니다.
content.meta.grantScope.indexes array<string> 로그 인덱스 이름 배열이며, 로그 권한 부여가 아니면 []일 수 있습니다.
content.meta.grantScope.indexes[*] string 인덱스 이름 또는 *입니다.
content.meta.grantScope.conditions object 네 가지 필터 조건이며, 구조는 생성 요청 conditions와 같고 완전하게 보존해야 합니다.
content.meta.auth object 이번 임시 인증 정보이며, 안전하게 권한 부여 대상자에게 전달해야 합니다.
content.meta.auth.tempAuthCode string 한 번의 교환에 사용하는 32자리 소문자 16진수 임시 코드이며, 생성 후 완전하게 전달하고 장기 API Key가 아닙니다.
content.meta.auth.tempAuthCodeExpireAt integer 임시 코드 만료 시간(Unix 초)이며, 패키지 유효 기한과 모두 충족해야 합니다.
content.meta.security object 서명 알고리즘 및 Key 자료입니다.
content.meta.security.signAlg string 현재 RS256입니다.
content.meta.security.kid string 서명을 생성한 Key 식별자입니다.
content.meta.signature string 전체 JWS 서명이며 예시 자리 표시자 값으로는 가져올 수 없습니다.
content.meta.grantScope.conditions.metric array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
content.meta.grantScope.conditions.metric[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
content.meta.grantScope.conditions.metric[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
content.meta.grantScope.conditions.metric[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
content.meta.grantScope.conditions.metric[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
content.meta.grantScope.conditions.metric[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
content.meta.grantScope.conditions.metric[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
content.meta.grantScope.conditions.tracing array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
content.meta.grantScope.conditions.tracing[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
content.meta.grantScope.conditions.tracing[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
content.meta.grantScope.conditions.tracing[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
content.meta.grantScope.conditions.tracing[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
content.meta.grantScope.conditions.tracing[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
content.meta.grantScope.conditions.tracing[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
content.meta.grantScope.conditions.rum array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
content.meta.grantScope.conditions.rum[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
content.meta.grantScope.conditions.rum[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
content.meta.grantScope.conditions.rum[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
content.meta.grantScope.conditions.rum[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
content.meta.grantScope.conditions.rum[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
content.meta.grantScope.conditions.rum[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
content.meta.grantScope.conditions.lineage array 선택적 조건 배열이며, 미입력 또는 []는 해당 카테고리에 조건을 추가하지 않음을 의미하고 해당 카테고리를 금지하는 것과 같지 않습니다.
content.meta.grantScope.conditions.lineage[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 마십시오.
content.meta.grantScope.conditions.lineage[*].name string 매칭할 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
content.meta.grantScope.conditions.lineage[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
content.meta.grantScope.conditions.lineage[*].logic string 동일 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 로직이 완전히 거부되지는 않으므로 클라이언트는 and/or만 입력하고 관대한 분기에 의존하지 마십시오.
content.meta.grantScope.conditions.lineage[*].value array 반드시 배열이어야 하며, 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 마십시오.
content.meta.grantScope.conditions.lineage[*].value[*] 실제 필드 값 하나의 매칭 대상 값이며, 유형과 대소문자는 데이터와 일치해야 합니다.
{
  "code": 200,
  "content": {
    "grantUUID": "grant_example",
    "status": "pending",
    "expireAt": 1785429000,
    "fileName": "cross-site-grant-wksp_target-example.json",
    "meta": {
      "version": "2026-05-27",
      "metaUUID": "meta_example",
      "createdAt": 1785427200,
      "expireAt": 1785429000,
      "sourceWorkspace": {
        "workspaceUUID": "wksp_source",
        "workspaceName": "권한 부여자 워크스페이스"
      },
      "targetWorkspaceUUID": "wksp_target",
      "sourceSite": {
        "siteCode": "source-region",
        "regionCode": "source-region",
        "name": "Guance 예시 사이트",
        "issuer": "https://source-site.example",
        "baseUrl": "https://source-site.example",
        "jwksUri": "https://source-site.example/api/v1/workspace_data/.well-known/cross-site-jwks.json",
        "kid": "key-example",
        "publicKeys": [
          {
            "kid": "key-example",
            "publicKey": "<서버에서 생성한 PEM 공개 키>"
          }
        ]
      },
      "grantScope": {
        "type": [
          "logging"
        ],
        "indexes": [
          "default"
        ],
        "conditions": {}
      },
      "auth": {
        "tempAuthCode": "0123456789abcdef0123456789abcdef",
        "tempAuthCodeExpireAt": 1785429000
      },
      "security": {
        "signAlg": "RS256",
        "kid": "key-example"
      },
      "signature": "<실제 권한 부여자 응답의 JWS, 예시는 가져올 수 없음>"
    },
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

conditions 자체는 공개 JSON 유형 검증에 의해 객체로 제한됩니다. 내부 검증은 여전히 객체가 아닌 값을 방어하지만, 일반 클라이언트에서는 이 오류가 먼저 파라미터 406으로 분류됩니다. 중첩 목록/단일 항목 형태는 전면적으로 검증되지 않아 500이 발생할 수 있으며, 모든 잘못된 조건이 전용 406을 받는다고 보장하지 않습니다.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드 누락 또는 필드 값이 선언된 검증 조건 위반 파라미터 파싱 실패 파라미터 위치, 필드명, 유형 및 값을 확인합니다.
400 ft.RequestJsonFormatError 요청 JSON 구문이 유효하지 않음 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정합니다.
400 ft.JsonFormatError 요청 JSON 최상위가 객체가 아님 일부 json 파일 형식 오류 요청 예시에 따라 JSON 객체를 제출합니다.
406 ft.CrossSiteGrantSiteIdentityMissing 현재 사이트 신원 설정이 불완전함 크로스 사이트 권한 부여 현재 사이트 신원 설정이 불완전합니다. 전역 frontApiServerUrlPrefixFormat 또는 CrossSiteGrantCfg 사용자 지정 issuer/baseUrl/jwksUri 및 인증서 keyId 설정을 확인하십시오 관리자가 배포 가이드에 따라 현재 사이트 신원과 주소를 확인합니다.
406 ft.CrossSiteGrantCertificateInvalid 현재 사이트의 유효한 서명 인증서가 초기화되지 않았거나 불완전함 크로스 사이트 권한 부여 인증서가 초기화되지 않았거나 불완전합니다. 먼저 크로스 사이트 권한 부여 인증서 초기화 스크립트를 실행하십시오 관리자가 활성 인증서를 초기화/복구하며, 본 인터페이스에 개인 키를 업로드하지 않습니다.
406 ft.CrossSiteGrantBeAccessedDisabled 현재 사이트의 동일 조직/외부 조직 피접근 스위치가 모두 활성화되지 않음 크로스 사이트 권한 부여가 활성화되지 않았습니다. 동일 조직 또는 외부 조직 피권한 부여 설정을 활성화하십시오 관리자가 실제 관계에 따라 해당 피접근 기능을 활성화합니다.
406 ft.CrossSiteGrantTargetWorkspaceInvalid 유효한 대상 UUID가 없거나 형식이 요구 사항에 맞지 않음 권한 부여 대상자 워크스페이스 UUID가 유효하지 않습니다. 확인 후 다시 입력하십시오 권한 부여 대상자에게 실제 wksp_ UUID를 받아 입력하며, 이름, 중국어 또는 앞뒤 공백을 입력하지 않습니다.
406 ft.WKSPIllegalAuthorization 대상 UUID가 현재 권한 부여자 워크스페이스와 같음 데이터 권한 부여 시 현재 워크스페이스가 아닌 ID를 입력해야 합니다. 다시 입력하십시오 다른 대상 워크스페이스를 사용합니다.
406 ft.WKSPRepeatAuthorization 동일 소스/대상에 pending, active 또는 호환되는 유효 권한 부여 레코드가 이미 존재 워크스페이스가 이미 권한 부여되었습니다. 중복 권한 부여하지 마십시오! 먼저 권한 부여 레코드를 확인하고 기존 권한 부여를 완료/취소하며, 반복 생성하지 마십시오.
406 ft.WorkspaceGrantConditionOperatorInvalid 네 가지 조건의 op가 in/not in이 아님 권한 부여 범위 {} 조건의 연산자는 in 또는 not in만 지원합니다 조건 설명에 따라 수정합니다.
406 ft.WorkspaceGrantConditionValueMustBeList 조건 value가 배열이 아님 권한 부여 범위 {} 조건의 value 필드는 목록이어야 합니다 배열로 변경합니다.
406 ft.WorkspaceGrantConditionLogicMixed 동일 카테고리 조건에서 서로 다른 logic 혼용 권한 부여 범위 {} 조건은 서로 다른 논리 연산자를 혼용할 수 없습니다 해당 카테고리의 논리를 통일합니다.
500 ft.InternalServerError 조건 중첩 형태 오류, 서명 생성, 저장 또는 응답 조합 예외 내부 오류 먼저 조건 구조 및 소스 권한 부여 레코드를 확인한 후 traceId로 처리합니다. 오류가 pending 레코드가 없음을 의미하지는 않습니다.

문서 평가

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