diff --git a/proto-docs/session.md b/proto-docs/session.md index 06d4c9b..8e557d0 100644 --- a/proto-docs/session.md +++ b/proto-docs/session.md @@ -179,8 +179,7 @@ Carries objects involved in the object session. ### Message RequestMetaHeader -Meta information attached to the request. When forwarded between peers, -request meta headers are folded in matryoshka style. +Meta information attached to the request (common things for all requests). | Field | Type | Label | Description | @@ -192,7 +191,9 @@ request meta headers are folded in matryoshka style. | session_token | [SessionToken](#neo.fs.v2.session.SessionToken) | | Session token within which the request is sent | | session_token_v2 | [SessionTokenV2](#neo.fs.v2.session.SessionTokenV2) | | Session token v2 with delegation chain support. Requests are invalid if both session_token and session_token_v2 are set. | | bearer_token | [neo.fs.v2.acl.BearerToken](#neo.fs.v2.acl.BearerToken) | | `BearerToken` with eACL overrides for the request | -| origin | [RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) | | `RequestMetaHeader` of the origin request | +| origin | [RequestMetaHeader](#neo.fs.v2.session.RequestMetaHeader) | | `RequestMetaHeader` of the origin request. + +DEPRECATED: Ignored since API v2.25, all requests are original. | | magic_number | [uint64](#uint64) | | NeoFS network magic. Must match the value for the network that the server belongs to. | @@ -206,8 +207,12 @@ Verification info for the request signed by all intermediate nodes. | ----- | ---- | ----- | ----------- | | body_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) | | Request Body signature. Should be generated once by the request initiator. | | meta_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) | | Request Meta signature is added and signed by each intermediate node | -| origin_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) | | Signature of previous hops | -| origin | [RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) | | Chain of previous hops signatures | +| origin_signature | [neo.fs.v2.refs.Signature](#neo.fs.v2.refs.Signature) | | Signature of previous hops. + +DEPRECATED: Unused and unchecked since API v2.25, no origin structure to check. | +| origin | [RequestVerificationHeader](#neo.fs.v2.session.RequestVerificationHeader) | | Chain of previous hops signatures. + +DEPRECATED: Unused and unchecked since API v2.25, no origin structure to check. | @@ -222,7 +227,9 @@ Information about the response | epoch | [uint64](#uint64) | | Peer's local epoch number | | ttl | [uint32](#uint32) | | Maximum number of intermediate nodes in the request route | | x_headers | [XHeader](#neo.fs.v2.session.XHeader) | repeated | Response X-Headers | -| origin | [ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) | | `ResponseMetaHeader` of the origin request | +| origin | [ResponseMetaHeader](#neo.fs.v2.session.ResponseMetaHeader) | | `ResponseMetaHeader` of the origin request. + +DEPRECATED: Unused for a long time, ignored since API v2.25. | | status | [neo.fs.v2.status.Status](#neo.fs.v2.status.Status) | | Status return | diff --git a/session/types.proto b/session/types.proto index 06c9b75..49a1b26 100644 --- a/session/types.proto +++ b/session/types.proto @@ -211,8 +211,7 @@ message XHeader { string value = 2 [json_name = "value"]; } -// Meta information attached to the request. When forwarded between peers, -// request meta headers are folded in matryoshka style. +// Meta information attached to the request (common things for all requests). message RequestMetaHeader { // Peer's API version used neo.fs.v2.refs.Version version = 1 [json_name = "version"]; @@ -236,7 +235,9 @@ message RequestMetaHeader { // `BearerToken` with eACL overrides for the request neo.fs.v2.acl.BearerToken bearer_token = 6 [json_name = "bearerToken"]; - // `RequestMetaHeader` of the origin request + // `RequestMetaHeader` of the origin request. + // + // DEPRECATED: Ignored since API v2.25, all requests are original. RequestMetaHeader origin = 7 [json_name = "origin"]; // NeoFS network magic. Must match the value for the network @@ -258,7 +259,9 @@ message ResponseMetaHeader { // Response X-Headers repeated XHeader x_headers = 4 [json_name = "xHeaders"]; - // `ResponseMetaHeader` of the origin request + // `ResponseMetaHeader` of the origin request. + // + // DEPRECATED: Unused for a long time, ignored since API v2.25. ResponseMetaHeader origin = 5 [json_name = "origin"]; // Status return @@ -271,10 +274,15 @@ message RequestVerificationHeader { neo.fs.v2.refs.Signature body_signature = 1 [json_name = "bodySignature"]; // Request Meta signature is added and signed by each intermediate node neo.fs.v2.refs.Signature meta_signature = 2 [json_name = "metaSignature"]; - // Signature of previous hops + + // Signature of previous hops. + // + // DEPRECATED: Unused and unchecked since API v2.25, no origin structure to check. neo.fs.v2.refs.Signature origin_signature = 3 [json_name = "originSignature"]; - // Chain of previous hops signatures + // Chain of previous hops signatures. + // + // DEPRECATED: Unused and unchecked since API v2.25, no origin structure to check. RequestVerificationHeader origin = 4 [json_name = "origin"]; }