クロスサイト認可 meta の生成¶
POST /api/v1/workspace_data/cross_site_grant/meta/create
概要¶
データ認可元が pending レコードおよび受け渡し可能な署名付き認可パッケージを生成します。
呼び出し前の準備と使用手順¶
dataRightsManage.workspaceConfigManage 権限を持つ API キーを使用します。ワークスペースはキーによって決まります。認可元はデータ提供側のワークスペース、認可先はデータをクエリする対象ワークスペースであり、両者は異なるワークスペースである必要があります。デプロイメントプランでは、先にデプロイメントプランのクロスサイト認可使用手順に従って、バージョン、自サイトアイデンティティ、証明書、許可するクロスサイト関係の設定を完了してください。秘密鍵は管理者がサーバー側で保持し、リクエスト/認可パッケージには含めません。
認可元サイトで呼び出し、対象 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 キー管理から、この操作権限を持つ OpenAPI キーを取得します。 |
Body リクエストパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| type[*] | string | 1 つのデータカテゴリ。* を含む場合はすべてを表します。利用可能なカテゴリには object/custom_object/keyevent/security/network/profiling なども含まれ、対象のクエリ機能に依存します。 例: logging取得または入力方法: 必要なデータカテゴリから選択し、ワイルドカードの誤用を避けてください。 |
|
| indexes[*] | string | 1 つのログインデックス名。正規化時に文字列に変換され、前後の空白が除去されます。 例: 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"]}取得または入力方法: 各項目に 1 つのフィールド条件を入力します。 |
|
| 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"]}取得または入力方法: 各項目に 1 つのフィールド条件を入力します。 |
|
| 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"]}取得または入力方法: 各項目に 1 つのフィールド条件を入力します。 |
|
| 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"]}取得または入力方法: 各項目に 1 つのフィールド条件を入力します。 |
|
| 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 はそれぞれ設定し、他のカテゴリにはこれら 4 種類のサブ条件を適用しません。ネスト構造は完全には検証されないため、各項目がオブジェクトであることを自身で保証する必要があります。 null を許可: False 例: {"metric": [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]}取得または入力方法: 認可元の実際のフィールドおよび許可値に基づいて構築し、本ページで確認済みの 4 種類の条件のみを使用します。 |
|
| 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 キーによって決まります。 |
| content.meta.sourceWorkspace.workspaceName | string | ソースワークスペース名のスナップショット。空の場合があります。 |
| content.meta.targetWorkspaceUUID | string | 認可先ワークスペースの UUID。インポートに使用するキーのワークスペースと一致する必要があります。 |
| 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 のベース URL。認可元から信頼できる形で提供され、接続可能である必要があります。 |
| content.meta.sourceSite.jwksUri | string | 認可元の公開鍵情報 URL。 |
| content.meta.sourceSite.kid | string | 現在有効な署名キー識別子。 |
| content.meta.sourceSite.publicKeys | array<object> | サーバー側で絞り込まれた公開鍵の集合。秘密鍵は含まれません。 |
| content.meta.sourceSite.publicKeys[*] | object | 1 件の公開鍵情報。 |
| content.meta.sourceSite.publicKeys[*].kid | string | 対応する公開鍵識別子。 |
| content.meta.sourceSite.publicKeys[*].publicKey | string | PEM 公開鍵の本文。秘密鍵や API キーではありません。 |
| content.meta.grantScope | object | 正規化済みの認可範囲。 |
| content.meta.grantScope.type | array<string> | データカテゴリの配列。 |
| content.meta.grantScope.type[*] | string | 1 つのカテゴリまたは *。 |
| content.meta.grantScope.indexes | array<string> | ログインデックス名の配列。ログ以外の認可では [] にできます。 |
| content.meta.grantScope.indexes[*] | string | インデックス名または *。 |
| content.meta.grantScope.conditions | object | 4 種類のフィルタ条件。構造は生成リクエストの conditions と一致し、完全に保持する必要があります。 |
| content.meta.auth | object | 今回の一時認証情報。認可先へ安全に受け渡す必要があります。 |
| content.meta.auth.tempAuthCode | string | 1 回の交換に使用する 32 桁の小文字 16 進数の一時コード。生成後は完全に受け渡します。長期的な API キーではありません。 |
| content.meta.auth.tempAuthCodeExpireAt | integer | 一時コードの有効期限(Unix 秒)。パッケージ有効期限とともに、両方を満たす必要があります。 |
| content.meta.security | object | 署名アルゴリズムとキー情報。 |
| content.meta.security.signAlg | string | 現在は RS256。 |
| content.meta.security.kid | string | 署名を生成したキー識別子。 |
| 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 | 4 種類の条件の op が in/not in ではない | 認可範囲 {} 条件の演算子は in または not in のみをサポートします | 条件の説明に従って修正してください。 |
| 406 | ft.WorkspaceGrantConditionValueMustBeList | 条件の value が配列ではない | 認可範囲 {} 条件の value フィールドはリストである必要があります | 配列に変更してください。 |
| 406 | ft.WorkspaceGrantConditionLogicMixed | 同一カテゴリの条件で異なる logic が混在 | 認可範囲 {} 条件では異なる論理演算子の混在をサポートしません | そのカテゴリのロジックを統一してください。 |
| 500 | ft.InternalServerError | 条件のネスト形状エラー、署名生成、保存、または応答組み立ての異常 | 内部エラー | まず条件構造とソース認可レコードを確認し、その後 traceId を使用して対処してください。エラーは pending レコードが存在しないことを意味しません。 |