콘텐츠로 이동

교차 사이트 권한 부여 meta 가져오기



POST /api/v1/workspace_data/cross_site_grant/meta/import

개요

권한 수임자 측에서 완전한 서명 패키지를 가져와 소스 측 인증을 완료하고 로컬 active 미러를 생성합니다.

호출 전 준비 및 사용 단계

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

권한 수임자 사이트에서 대상 워크스페이스의 Key로 {meta: 전체 권한 부여 패키지}를 제출합니다. 먼저 패키지 출처, targetWorkspaceUUID, 만료 시간 및 권한 부여 범위를 확인합니다. 현재 공개 Body는 meta만 허용하며, controller 내부의 authResult를 사용하거나 meta의 각 필드를 요청 최상위에 직접 펼쳐 넣는 방식은 지원하지 않습니다. meta 생성이 반환한 content.meta를 읽어 파일 형태로 완전하게 전달하며, 이 페이지의 예시용 공개 키/JWS를 제출하거나 개인 키를 추가해서는 안 됩니다.

대상 서버는 패키지를 검증한 후 권한 부여자 측에 주도적으로 인증을 요청하며(기본 요청 타임아웃 10초, 사이트별 설정 가능), 권한 부여자는 대상 측에 주도적으로 연결하지 않습니다. 호출자 PC에서만 접근 가능한 것이 아니라 대상 서버가 패키지에 포함된 권한 부여자 주소에 접근할 수 있어야 합니다. 양측의 해당 교차 사이트 관계가 활성화되어야 하며, 동일 조직 대상은 유효한 공식 사이트 정보도 필요합니다. 동일 사이트 내 워크스페이스 권한 부여는 사이트 내 권한 부여를 사용해야 합니다.

로컬에 active mirror가 성공적으로 생성된 후에만 권한 부여 선택 및 조회 체인에 진입할 수 있습니다. 인증 교환과 로컬 저장은 양측에서 각각 제출하는 것이며, 실패 시 이미 소스 측이 활성화되고 임시 코드가 소모되었을 수 있으므로 원본 패키지를 무한히 재사용할 수 있다고 가정해서는 안 됩니다. 동일한 유효 미러는 일반적으로 원격 교환 전에 중복 오류를 반환하며, duplicated=true는 특정 기존 레코드를 재사용하는 분기일 뿐 멱등 재시도 보장을 제공하지 않습니다. 실패 시 먼저 양측의 권한 부여 기록 목록을 각각 확인한 후 복구/철회/재생성을 결정합니다.

요청 헤더

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

Body 요청 파라미터

파라미터 이름 유형 필수 설명
meta.version string 생성된 프로토콜 버전이며 현재는 2026-05-27이고 원본 값을 유지합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 version에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.metaUUID string 이번 권한 부여 패키지의 식별자이며 이후 교환에 사용됩니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 metaUUID에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.createdAt integer 생성 시간, Unix 초.
예시: 1785427200
획득 또는 입력 방법: 실제 권한 부여 패키지의 createdAt에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.expireAt integer 권한 부여 패키지 만료 시간, Unix 초. 이 시간 이전에 가져와야 합니다.
예시: 1785427200
획득 또는 입력 방법: 실제 권한 부여 패키지의 expireAt에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceWorkspace object 데이터 권한 부여자 워크스페이스 정보입니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceWorkspace에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceWorkspace.workspaceUUID string 권한 부여자 워크스페이스 UUID이며 소스 API Key로 결정됩니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceWorkspace.workspaceUUID에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceWorkspace.workspaceName string 소스 워크스페이스 이름 스냅샷이며 비어 있을 수 있습니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceWorkspace.workspaceName에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.targetWorkspaceUUID string 권한 수임자 워크스페이스 UUID이며 가져오기에 사용한 Key의 워크스페이스와 같아야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 targetWorkspaceUUID에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite object 권한 부여자 사이트 정체성과 접근 주소이며 서버 측에서 제공합니다. 브랜드/도메인을 임의로 입력하거나 교체하지 않습니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.siteCode string 권한 부여자 사이트 코드입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.siteCode에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.regionCode string 권한 부여자 리전 코드이며 패키지 원본 값으로 전달합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.regionCode에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.name string 사이트 표시 이름입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.name에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.issuer string 권한 부여자 서명 정체성입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.issuer에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.baseUrl string 가져오는 측 서버가 주도적으로 요청하는 권한 부여자 API 기본 주소이며, 권한 부여자가 신뢰할 수 있게 제공해야 하고 연결 가능해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.baseUrl에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.jwksUri string 권한 부여자 공개 키 자료 주소입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.jwksUri에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.kid string 현재 활성 서명 Key 식별자입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.kid에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.publicKeys array<object> 서버 측에서 필터링한 공개 키 집합이며 개인 키는 포함하지 않습니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.publicKeys에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.publicKeys[*] object 하나의 공개 키 자료입니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.publicKeys[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.publicKeys[*].kid string 해당 공개 키 식별자입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.publicKeys[*].kid에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.sourceSite.publicKeys[*].publicKey string PEM 공개 키 본문이며 개인 키나 API Key가 아닙니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 sourceSite.publicKeys[*].publicKey에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope object 정규화된 권한 부여 범위입니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.type array<string> 데이터 카테고리 배열입니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.type에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.type[*] string 하나의 카테고리 또는 *입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.type[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.indexes array<string> 로그 인덱스 이름 배열이며 로그 권한 부여가 아니면 []일 수 있습니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.indexes에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.indexes[*] string 인덱스 이름 또는 *입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.indexes[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions object 네 가지 유형의 필터 조건입니다. 구조는 생성 요청의 conditions와 동일하며 완전하게 유지해야 합니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.auth object 이번 임시 인증 정보이며 권한 수임자에게 안전하게 전달해야 합니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 auth에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.auth.tempAuthCode string 한 번의 교환에 사용하는 32자리 소문자 16진수 임시 코드이며, 생성 후 완전하게 전달하고 장기 API Key가 아닙니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 auth.tempAuthCode에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.auth.tempAuthCodeExpireAt integer 임시 코드 만료 시간, Unix 초. 패키지 유효 기간과 모두 충족해야 합니다.
예시: 1785427200
획득 또는 입력 방법: 실제 권한 부여 패키지의 auth.tempAuthCodeExpireAt에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.security object 서명 알고리즘과 Key 자료입니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 security에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.security.signAlg string 현재 RS256입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 security.signAlg에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.security.kid string 서명을 생성한 Key 식별자입니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 security.kid에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.signature string 완전한 JWS 서명이며 예시 자리표시자 값으로는 가져올 수 없습니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 signature에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.metric array 선택 조건 배열입니다. 입력하지 않거나 []이면 이 카테고리에 조건을 추가하지 않는다는 의미이며, 해당 카테고리를 금지한다는 뜻은 아닙니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.metric에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.metric[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 않습니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.metric[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.metric[*].name string 매칭 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.metric[*].name에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.metric[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.metric[*].op에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.metric[*].logic string 같은 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 논리는 완전히 거부되지 않으므로 클라이언트는 and/or만 입력해야 하며 관대한 분기에 의존하지 않아야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.metric[*].logic에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.metric[*].value array 반드시 배열이어야 합니다. 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 않습니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.metric[*].value에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.metric[*].value[*] 실제 필드 값 매칭할 값 하나입니다. 유형과 대소문자는 데이터와 일치해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.metric[*].value[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.tracing array 선택 조건 배열입니다. 입력하지 않거나 []이면 이 카테고리에 조건을 추가하지 않는다는 의미이며, 해당 카테고리를 금지한다는 뜻은 아닙니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.tracing에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.tracing[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 않습니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.tracing[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.tracing[*].name string 매칭 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.tracing[*].name에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.tracing[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.tracing[*].op에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.tracing[*].logic string 같은 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 논리는 완전히 거부되지 않으므로 클라이언트는 and/or만 입력해야 하며 관대한 분기에 의존하지 않아야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.tracing[*].logic에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.tracing[*].value array 반드시 배열이어야 합니다. 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 않습니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.tracing[*].value에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.tracing[*].value[*] 실제 필드 값 매칭할 값 하나입니다. 유형과 대소문자는 데이터와 일치해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.tracing[*].value[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.rum array 선택 조건 배열입니다. 입력하지 않거나 []이면 이 카테고리에 조건을 추가하지 않는다는 의미이며, 해당 카테고리를 금지한다는 뜻은 아닙니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.rum에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.rum[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 않습니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.rum[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.rum[*].name string 매칭 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.rum[*].name에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.rum[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.rum[*].op에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.rum[*].logic string 같은 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 논리는 완전히 거부되지 않으므로 클라이언트는 and/or만 입력해야 하며 관대한 분기에 의존하지 않아야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.rum[*].logic에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.rum[*].value array 반드시 배열이어야 합니다. 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 않습니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.rum[*].value에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.rum[*].value[*] 실제 필드 값 매칭할 값 하나입니다. 유형과 대소문자는 데이터와 일치해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.rum[*].value[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.lineage array 선택 조건 배열입니다. 입력하지 않거나 []이면 이 카테고리에 조건을 추가하지 않는다는 의미이며, 해당 카테고리를 금지한다는 뜻은 아닙니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.lineage에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.lineage[*] object 각 항목은 객체여야 하며 문자열이나 null로 대체하지 않습니다.
예시: {}
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.lineage[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.lineage[*].name string 매칭 필드 이름이며 표시 별칭이 아닙니다. 현재 생성 검증은 필드 존재 여부를 전면적으로 확인하지 않으므로 통제된 데이터로 범위를 검증해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.lineage[*].name에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.lineage[*].op string in 포함, not in 제외만 지원하며 = 등의 기호는 지원하지 않습니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.lineage[*].op에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.lineage[*].logic string 같은 카테고리에서 혼용하면 406이 발생합니다. 알 수 없는 논리는 완전히 거부되지 않으므로 클라이언트는 and/or만 입력해야 하며 관대한 분기에 의존하지 않아야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.lineage[*].logic에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.lineage[*].value array 반드시 배열이어야 합니다. 요소는 실제 필드와 일치하는 값을 사용하고 쉼표 문자열로 배열을 대체하지 않습니다.
예시: []
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.lineage[*].value에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta.grantScope.conditions.lineage[*].value[*] 실제 필드 값 매칭할 값 하나입니다. 유형과 대소문자는 데이터와 일치해야 합니다.
예시: <保留授权方原值>
획득 또는 입력 방법: 실제 권한 부여 패키지의 grantScope.conditions.lineage[*].value[*]에서 원본 그대로 가져오며 임의로 구성하지 않습니다.
meta json 완전한 패키지를 객체로 제출하며 파일 이름/JSON 문자열/응답 래퍼가 아닙니다. 필드와 값을 수정하지 않으며 JSON 공백과 키 순서 변경은 허용됩니다.
null 허용: False
예시: {"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,示例不能导入>"}
획득 또는 입력 방법: 반드시 권한 부여자가 실제로 meta 생성한 응답의 content.meta 또는 그가 저장한 완전한 파일을 사용해야 합니다.

파라미터 추가 설명

권한 수임자는 권한 부여자가 생성한 교차 사이트 권한 부여 meta를 가져옵니다. 가져온 후 권한 수임자가 주도적으로 권한 부여자 사이트에 접속하여 인증과 동기화를 완료하며, 권한 부여자는 권한 수임자에게 주도적으로 접속하지 않습니다.

자세한 내용은 배포 플랜 교차 사이트 권한 부여 사용 안내를 참고하십시오.

  • 배포 플랜 서비스는 최소 2026-06-03 릴리스 버전으로 업그레이드해야 새 버전의 사이트 간 권한 부여 방식을 지원합니다.
  • 가져오기에 성공하면 로컬에 mirror 권한 부여 레코드가 생성됩니다. 이 레코드가 active 상태가 된 후에야 워크스페이스 선택기, 권한 부여 검증 및 DQL 조회에서 사용할 수 있습니다.
  • 동일한 유효 meta를 반복해서 가져오면 기존 권한 부여 또는 중복 권한 부여 오류가 반환되며, 구체적인 내용은 인터페이스 응답을 기준으로 합니다.
  • 이후 비즈니스 수정과 철회는 여전히 /wksp_share/<uuid>/modify와 /wksp_share/delete를 사용합니다.

요청 예시

# grant-meta.json 은 권한 부여자의 실제 응답 content.meta에서 가져온 것이며, 성공 여부와 대상 워크스페이스를 확인한 파일입니다.
jq '{meta: .}' grant-meta.json > grant-import.json
curl --request POST 'https://openapi.guance.com/api/v1/workspace_data/cross_site_grant/meta/import' \
  -H 'DF-API-KEY: <被授权方API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-binary @guance.com

응답

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

필드 유형 설명
content.grantUUID string 대상 사이트 로컬 mirror 레코드 UUID이며 소스 측 grantUUID와 같지 않습니다.
content.status string 성공 시 active이며 로컬에 사용 가능한 미러가 저장되었음을 나타내고, 실제 조회 환경이 모두 검증되었다고 보장하지는 않습니다.
content.recordRole string mirror, 권한 수임자 로컬 레코드 역할입니다.
content.duplicated boolean false는 신규 생성이며, 특정 기존 레코드 재사용은 true일 수 있습니다. 일반적인 중복 가져오기도 직접 오류를 반환할 수 있어 멱등성을 보장하지 않습니다.
content.sourceWorkspaceUUID string 데이터 제공자 워크스페이스입니다.
content.targetWorkspaceUUID string 대상 Key의 현재 워크스페이스입니다.
content.sourceWorkspaceName string 권한 부여자 이름 스냅샷이며 비어 있을 수 있습니다.
content.targetWorkspaceName string 대상 워크스페이스 이름이며 비어 있을 수 있습니다.
content.regionCode string 신규 생성 분기는 정규화된 소스 측 리전 코드를 반환하며, 재사용 분기에서는 생략될 수 있습니다.
content.toRegionCode string 신규 생성 분기는 대상 리전 코드를 반환하며, 재사용 분기에서는 생략될 수 있습니다.
content.siteRelationType string same_org_cross_site 또는 external_org_cross_site. 신규 생성 시 반환되며 재사용 시 생략될 수 있습니다.
content.declaration object 대상 워크스페이스 공통 선언입니다.
{
  "code": 200,
  "content": {
    "grantUUID": "grant_mirror_example",
    "status": "active",
    "recordRole": "mirror",
    "duplicated": false,
    "sourceWorkspaceUUID": "wksp_source",
    "targetWorkspaceUUID": "wksp_target",
    "sourceWorkspaceName": "授权方空间",
    "targetWorkspaceName": "目标空间",
    "regionCode": "source-region",
    "toRegionCode": "target-region",
    "siteRelationType": "same_org_cross_site",
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

예시는 정상적인 신규 생성 분기만 보여주며, controller 내부의 authResult 재생 경로는 공개 Body에 속하지 않습니다. 개인 키 필드는 공통 진입점에서 재귀적으로 정리됩니다. auth.tempAuthCode는 여전히 민감한 일회 교환 데이터이므로 합법적인 대상에게만 안전하게 전달해야 합니다.

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.CrossSiteGrantTargetWorkspaceMismatch 패키지 대상 UUID가 현재 Key 워크스페이스가 아님 권한 부여 패키지의 대상 워크스페이스가 현재 워크스페이스와 일치하지 않습니다. 올바른 워크스페이스로 전환한 후 다시 가져오십시오 올바른 대상 사이트/워크스페이스 Key로 전환하며, 서명 패키지를 수정하여 억지로 맞추지 않습니다.
406 ft.CrossSiteGrantPackageInvalid 패키지 필드/서명 무효, 메타데이터 변경 또는 형식 불완전 권한 부여 패키지가 유효하지 않거나 변조되었습니다. 권한 부여자가 생성한 권한 부여 패키지를 다시 가져오십시오 권한 부여자가 생성한 완전한 meta를 다시 받습니다.
406 ft.CrossSiteGrantPackageExpired 패키지 또는 임시 코드 만료 권한 부여 패키지가 만료되었습니다. 권한 부여자에게 문의하여 권한 부여 패키지를 다시 생성하십시오 권한 부여 기록에서 기존 pending을 처리한 후 재생성하며, 패키지 시간을 수동으로 연장하지 않습니다.
406 ft.CrossSiteGrantRelationDisabled 이번 접근 관계 또는 양측 대응 기능이 활성화되지 않음 교차 사이트 권한 부여가 활성화되지 않았습니다. 설정 항목을 활성화하십시오: {} 관리자가 실제 관계에 따라 해당 설정을 활성화하며, 요청으로 관계를 위조할 수 없습니다.
406 ft.CrossSiteGrantSameOrgSiteUnresolved 동일 조직 소스 사이트 정보가 초기화되지 않았거나, 공식 집합에 없거나, 주소가 일치하지 않음 동일 조직 교차 사이트 권한 부여 사이트가 초기화되지 않았거나 AllSiteBaseUrls 공식 사이트 집합에 없습니다: {} 관리자가 사이트 정보를 확인하며, 패키지 URL을 임의로 수정하지 않습니다.
406 ft.CrossSiteGrantSameSiteNotAllowed 동일 사이트 관계로 가져오기 동일 사이트 워크스페이스 간 권한 부여는 사이트 내 권한 부여 인터페이스를 사용하십시오. 교차 사이트 권한 부여 프로토콜로는 생성할 수 없습니다 사이트 내 권한 부여 인터페이스를 사용합니다.
406 ft.WKSPRepeatAuthorization 현재 대상에 동일한 유효 소스 사이트/소스 워크스페이스 미러가 이미 존재 워크스페이스가 이미 권한 부여되었습니다. 중복 권한 부여하지 마십시오! 기존 권한 부여를 재사용하며, 재생성이 필요하면 먼저 확인하고 절차에 따라 철회합니다.
406 ft.CrossSiteGrantAuthFailed 원격 타임아웃/비성공, 임시 코드 소모 실패, 서명 정체성 또는 교환 자료 불일치 교차 사이트 권한 부여 인증에 실패했습니다. 권한 부여 패키지가 여전히 유효한지 확인한 후 다시 시도하십시오 양측 권한 부여 상태와 연결성을 확인하고 traceId를 보관하며, 이미 소모된 패키지를 무작정 재생하지 않습니다.
500 ft.InternalServerError 비정상 패키지 중첩, 서명 요청 구성, 데이터베이스 제출 또는 응답 처리 실패 내부 오류 패키지 무결성과 양측 기록을 확인하고 traceId로 조사합니다. 실패가 소스 측 비활성화를 증명하지는 않습니다.

문서 평가

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