クロスサイト認証メタのインポート¶
POST /api/v1/workspace_data/cross_site_grant/meta/import
概要¶
Body リクエストパラメータ¶
| パラメータ名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| meta | json | 認証元が生成した完全なクロスサイト認証メタ JSON 空許容: False |
パラメータ補足説明¶
被認証先が認証元の生成したクロスサイト認証メタをインポートします。インポート後、被認証先が認証元のサイトにアクセスして認証と同期を行います。認証元は被認証先にアクセスしません。
詳細は以下を参照: デプロイメントプラン クロスサイト認証 使用説明
- デプロイメントプランサービスは、少なくとも2026-06-03リリースバージョンにアップグレードする必要があります。その後、新しいバージョンのサイト間認証方式がサポートされます。
- インポートが成功すると、ローカルにミラー認証レコードが生成されます。このレコードがアクティブになると、ワークスペースセレクター、権限チェック、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"
}