The session metadata is provided all at once when a new bsr is opened. While the session recording metadata records metadata about a recording while the recording is happening, notably it records each time a new connection occurs. The nested structure of the session metadata does not lend itself to the append-only syntax of the recording meta file. In addition we do not want to mix different kinds of metadata together. Thus the session metadata is now written to a separate file in the BSR, and is written as JSON which better handles the nested structure and allows for simpler encoding/decoding. Similarly the summary files are intended to be written to as containers close and have been switched to JSON.
175 lines
5.3 KiB
Go
175 lines
5.3 KiB
Go
// Copyright (c) HashiCorp, Inc.
|
|
// SPDX-License-Identifier: MPL-2.0
|
|
|
|
package bsr
|
|
|
|
// Scope contains information about the scope of a Boundary domain object
|
|
type Scope struct {
|
|
PublicId string
|
|
Name string // optional
|
|
Description string // optional
|
|
Type string
|
|
ParentId string // optional
|
|
PrimaryAuthMethodId string // optional
|
|
}
|
|
|
|
// User contains information about user who initiated this session
|
|
type User struct {
|
|
PublicId string
|
|
Scope Scope
|
|
Name string // optional field
|
|
Description string // optional field
|
|
}
|
|
|
|
// Target contains information about the target for this session
|
|
type Target struct {
|
|
PublicId string
|
|
Scope Scope
|
|
Name string // optional field
|
|
Description string // optional field
|
|
DefaultPort uint32
|
|
SessionMaxSeconds uint32
|
|
SessionConnectionLimit int32
|
|
WorkerFilter string // optional field
|
|
EgressWorkerFilter string // optional field
|
|
IngressWorkerFilter string // optional field
|
|
}
|
|
|
|
// Worker contains information about the worker used to record this session
|
|
type Worker struct {
|
|
PublicId string
|
|
Version string
|
|
Sha string
|
|
}
|
|
|
|
// StaticHostCatalog contains information about the static host catalog for this session
|
|
type StaticHostCatalog struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
}
|
|
|
|
// StaticHost contains information about the static host for this session
|
|
type StaticHost struct {
|
|
PublicId string
|
|
Catalog StaticHostCatalog
|
|
Name string // optional field
|
|
Description string // optional field
|
|
Address string
|
|
}
|
|
|
|
// DynamicHostCatalog contains information about the dynamic host catalog for this session
|
|
type DynamicHostCatalog struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
PluginId string
|
|
Attributes string
|
|
}
|
|
|
|
// DynamicHost contains information about the dynamic host for this session
|
|
type DynamicHost struct {
|
|
PublicId string
|
|
Catalog DynamicHostCatalog
|
|
Name string // optional field
|
|
Description string // optional field
|
|
ExternalId string
|
|
}
|
|
|
|
// StaticCredentialStore represents a static credential store used for this session
|
|
type StaticCredentialStore struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
StaticJsonCredentials []StaticJsonCredential
|
|
StaticUsernamePasswordCredentials []StaticUsernamePasswordCredential
|
|
}
|
|
|
|
// StaticJsonCredential represents a static json credential used for this session
|
|
type StaticJsonCredential struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
ObjectHmac []byte
|
|
}
|
|
|
|
// StaticUsernamePasswordCredential represents a Static username password credential used for this session
|
|
type StaticUsernamePasswordCredential struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
PasswordHmac []byte
|
|
}
|
|
|
|
// StaticSshPrivateKeyCredential represents a Static Ssh private key credential used for this session
|
|
type StaticSshPrivateKeyCredential struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
PrivateKeyHmac []byte
|
|
PrivateKeyPassphraseHmac []byte // optional field
|
|
}
|
|
|
|
// VaultCredentialStore represents a Vault credential store used for this session
|
|
type VaultCredentialStore struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
VaultAddress string
|
|
Namespace string
|
|
TlsServerName string
|
|
TlsSkipVerify bool
|
|
WorkerFilter string // optional field
|
|
VaultGenericLibraries []VaultLibrary
|
|
VaultSshCertLibraries []VaultSshCertLibrary
|
|
}
|
|
|
|
// VaultLibrary contains information about the Vault library used for this session
|
|
type VaultLibrary struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
VaultPath string
|
|
HttpMethod string
|
|
HttpRequestBody []byte // optional field
|
|
CredentialType string
|
|
}
|
|
|
|
// VaultSshCertLibrary contains information about a Vault Ssh Cert library for this session
|
|
type VaultSshCertLibrary struct {
|
|
PublicId string
|
|
ProjectId string
|
|
Name string // optional field
|
|
Description string // optional field
|
|
VaultPath string
|
|
Username string
|
|
KeyType string
|
|
KeyBits int
|
|
Ttl string // optional field
|
|
CriticalOptions []byte // optional field
|
|
Extensions []byte // optional field
|
|
CredentialType string // optional field
|
|
}
|
|
|
|
// SessionMeta contains metadata about a session in a BSR.
|
|
type SessionMeta struct {
|
|
PublicId string
|
|
User *User
|
|
Target *Target
|
|
Worker *Worker
|
|
// StaticHost and DynamicHost are mutually exclusive
|
|
StaticHost *StaticHost
|
|
DynamicHost *DynamicHost
|
|
|
|
StaticCredentialStore []StaticCredentialStore
|
|
VaultCredentialStore []VaultCredentialStore
|
|
}
|