사이트 간 권한 부여 메타 가져오기¶
POST /api/v1/workspace_data/cross_site_grant/meta/import
개요¶
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| meta | json | 권한 부여자가 생성한 전체 사이트 간 권한 부여 메타 JSON 빈 값 허용: False |
매개변수 추가 설명¶
피권한 부여자가 권한 부여자가 생성한 사이트 간 권한 부여 메타를 가져옵니다. 가져오기 후 피권한 부여자가 권한 부여자 사이트에 접속하여 인증 및 동기화를 수행하며, 권한 부여자는 피권한 부여자에게 능동적으로 접속하지 않습니다.
자세한 내용은 다음을 참조하세요: 배포 플랜 사이트 간 권한 부여 사용 설명
- 배포 플랜 서비스는 최소 2026-06-03 릴리스 버전으로 업그레이드되어야 새로운 버전의 사이트 간 권한 부여 방식을 지원합니다.
- 가져오기 성공 후 로컬에 mirror 권한 부여 레코드가 생성됩니다. 이 레코드가 active 상태가 되어야 워크스페이스 선택기, 권한 부여 검증 및 DQL 쿼리에서 사용할 수 있습니다.
- 동일한 유효 메타를 중복 가져오면 기존 권한 부여 또는 중복 권한 부여 오류가 발생하며, 구체적인 내용은 인터페이스 응답을 따릅니다.
- 이후 비즈니스 수정 및 철회는 계속
/wksp_share/<uuid>/modify및/wksp_share/delete를 사용합니다.
요청 예시¶
curl 'https://openapi.guance.com/api/v1/workspace_data/cross_site_grant/meta/import' \
-H 'Content-Type: application/json' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"meta":{"version":"2026-05-27","metaUUID":"meta_1","sourceWorkspace":{"workspaceUUID":"wksp_source","workspaceName":"권한 부여자 워크스페이스"},"targetWorkspaceUUID":"wksp_target","sourceSite":{"regionCode":"testing","publicKeys":[{"kid":"kid_1","publicKey":"-----BEGIN PUBLIC KEY-----..."}]},"grantScope":{"type":["logging"],"indexes":["*"],"conditions":{}},"auth":{"tempAuthCode":"temp_code_xxx","tempAuthCodeExpireAt":1770000000},"security":{"signAlg":"RS256","kid":"kid_1"},"signature":"<JWS>"}}' \
--compressed
응답¶
{
"code": 200,
"content": {
"grantUUID": "grant_mirror_1",
"status": "active",
"recordRole": "mirror",
"duplicated": false,
"sourceWorkspaceUUID": "wksp_source",
"targetWorkspaceUUID": "wksp_target",
"sourceWorkspaceName": "권한 부여자 워크스페이스",
"targetWorkspaceName": "피권한 부여자 워크스페이스",
"regionCode": "testing",
"toRegionCode": "us1",
"siteRelationType": "same_org_cross_site"
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}