60 lines
1.8 KiB
Protocol Buffer
60 lines
1.8 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
package session;
|
|
|
|
option go_package = "github.com/nspcc-dev/neofs-api-go/session";
|
|
option csharp_namespace = "NeoFS.API.Session";
|
|
|
|
import "refs/types.proto";
|
|
import "service/meta.proto";
|
|
import "service/verify.proto";
|
|
|
|
service Session {
|
|
// Create opens new session between the client and the server.
|
|
rpc Create (CreateRequest) returns (CreateResponse);
|
|
}
|
|
|
|
// CreateRequest carries an information necessary for opening a session.
|
|
message CreateRequest {
|
|
message Body {
|
|
// Carries an identifier of a session initiator.
|
|
refs.OwnerID owner_id = 1;
|
|
|
|
// Carries a lifetime of the session.
|
|
service.TokenLifetime lifetime = 2;
|
|
}
|
|
|
|
// Body of create session token request message.
|
|
Body body = 1;
|
|
|
|
// Carries request meta information. Header data is used only to regulate message
|
|
// transport and does not affect request execution.
|
|
service.RequestMetaHeader meta_header = 2;
|
|
|
|
// Carries request verification information. This header is used to authenticate
|
|
// the nodes of the message route and check the correctness of transmission.
|
|
service.RequestVerificationHeader verify_header = 3;
|
|
}
|
|
|
|
// CreateResponse carries an information about the opened session.
|
|
message CreateResponse {
|
|
message Body {
|
|
// id carries an identifier of session token.
|
|
bytes id = 1;
|
|
|
|
// session_key carries a session public key.
|
|
bytes session_key = 2;
|
|
}
|
|
|
|
// Body of create session token response message.
|
|
Body body = 1;
|
|
|
|
// Carries response meta information. Header data is used only to regulate
|
|
// message transport and does not affect request execution.
|
|
service.ResponseMetaHeader meta_header = 2;
|
|
|
|
// Carries response verification information. This header is used to
|
|
// authenticate the nodes of the message route and check the correctness
|
|
// of transmission.
|
|
service.ResponseVerificationHeader verify_header = 3;
|
|
}
|