syntax = "proto3";

package session;

option go_package = "github.com/nspcc-dev/neofs-api-go/session";
option csharp_namespace = "NeoFS.API.Session";

import "service/meta.proto";
import "service/verify.proto";
import "refs/types.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 {
    // Carries an identifier of a session initiator.
    refs.OwnerID OwnerID = 1;

    // Carries a lifetime of the session.
    service.TokenLifetime Lifetime = 2;

    // Carries request meta information. Header data is used only to regulate message
    // transport and does not affect request execution.
    service.RequestMetaHeader MetaHeader = 98;

    // Carries request verification information. This header is used to authenticate
    // the nodes of the message route and check the correctness of transmission.
    service.RequestVerificationHeader VerifyHeader = 99;
}

// CreateResponse carries an information about the opened session.
message CreateResponse {
    // ID carries an identifier of session token.
    bytes ID = 1;

    // SessionKey carries a session public key.
    bytes SessionKey = 2;
}