Documentation
¶
Overview ¶
Package httpserver contains the DANS HTTP trust-boundary and lifecycle.
Index ¶
- Constants
- func AccessLog(logger *slog.Logger) func(http.Handler) http.Handler
- func ActorFromContext(ctx context.Context) (database.Actor, bool)
- func Authentication(authenticator Authenticator) func(http.Handler) http.Handler
- func Chain(handler http.Handler, middleware ...Middleware) http.Handler
- func ContractOperationIDs() (map[string]struct{}, error)
- func GracefulShutdown(parent context.Context, server shutdownServer, health *Health, ...) error
- func ListenAndServe(ctx context.Context, server *http.Server, health *Health, ...) error
- func NewApplicationHandler(config ApplicationConfig) (http.Handler, error)
- func NewGeneratedServer(strict api.StrictServerInterface) api.ServerInterface
- func NewHTTPServer(config ServerConfig, handler http.Handler) (*http.Server, error)
- func NewJSONLogger(output io.Writer, level slog.Leveler) *slog.Logger
- func NewRootHandler(health *Health, contractJSON []byte, API http.Handler) (http.Handler, error)
- func RequestIDFromContext(ctx context.Context) string
- func Serve(ctx context.Context, server *http.Server, health *Health, ...) error
- func WithRequestID(ctx context.Context, requestID string) context.Context
- type AccessMetadata
- func (metadata *AccessMetadata) SetActorID(actorID string)
- func (metadata *AccessMetadata) SetOpaqueIDs(actorID, resourceID, operationID string)
- func (metadata *AccessMetadata) SetOperationID(operationID string)
- func (metadata *AccessMetadata) SetRateLimit(decision ratelimit.Decision)
- func (metadata *AccessMetadata) SetResourceID(resourceID string)
- func (metadata *AccessMetadata) SetRoute(template, apiOperationID string)
- func (metadata *AccessMetadata) SetUpstreamOutcome(outcome string)
- type ApplicationConfig
- type AuditFailureReporter
- type AuditHandler
- type AuditHealth
- type AuditStore
- type Authenticator
- type AuthorizationDenialAuditor
- type BoundaryConfig
- type BrowseHandler
- type BrowseStore
- type BrowserSessionStore
- type BrowserSessions
- type CompatibilityConfig
- type DANSOperations
- type DelegationHandler
- func (handler *DelegationHandler) CreateDelegation(ctx context.Context, request api.CreateDelegationRequestObject) (api.CreateDelegationResponseObject, error)
- func (handler *DelegationHandler) GetDelegation(ctx context.Context, request api.GetDelegationRequestObject) (api.GetDelegationResponseObject, error)
- func (handler *DelegationHandler) ListCurrentIdentityDelegations(ctx context.Context, request api.ListCurrentIdentityDelegationsRequestObject) (api.ListCurrentIdentityDelegationsResponseObject, error)
- func (handler *DelegationHandler) ListDelegations(ctx context.Context, request api.ListDelegationsRequestObject) (api.ListDelegationsResponseObject, error)
- func (handler *DelegationHandler) ListIdentityAssignments(ctx context.Context, request api.ListIdentityAssignmentsRequestObject) (api.ListIdentityAssignmentsResponseObject, error)
- func (handler *DelegationHandler) ListIdentityDelegations(ctx context.Context, request api.ListIdentityDelegationsRequestObject) (api.ListIdentityDelegationsResponseObject, error)
- func (handler *DelegationHandler) RevokeDelegation(ctx context.Context, request api.RevokeDelegationRequestObject) (api.RevokeDelegationResponseObject, error)
- type DelegationStore
- type Dependencies
- type GeneratedConfig
- type Health
- type IAMHandler
- func (handler *IAMHandler) AddGroupMember(ctx context.Context, request api.AddGroupMemberRequestObject) (api.AddGroupMemberResponseObject, error)
- func (handler *IAMHandler) CreateCurrentIdentityToken(ctx context.Context, request api.CreateCurrentIdentityTokenRequestObject) (api.CreateCurrentIdentityTokenResponseObject, error)
- func (handler *IAMHandler) CreateGroup(ctx context.Context, request api.CreateGroupRequestObject) (api.CreateGroupResponseObject, error)
- func (handler *IAMHandler) CreateIdentity(ctx context.Context, request api.CreateIdentityRequestObject) (api.CreateIdentityResponseObject, error)
- func (handler *IAMHandler) CreateIdentityToken(ctx context.Context, request api.CreateIdentityTokenRequestObject) (api.CreateIdentityTokenResponseObject, error)
- func (handler *IAMHandler) GetCurrentCredential(ctx context.Context, _ api.GetCurrentCredentialRequestObject) (api.GetCurrentCredentialResponseObject, error)
- func (handler *IAMHandler) GetCurrentIdentity(ctx context.Context, _ api.GetCurrentIdentityRequestObject) (api.GetCurrentIdentityResponseObject, error)
- func (handler *IAMHandler) GetGroup(ctx context.Context, request api.GetGroupRequestObject) (api.GetGroupResponseObject, error)
- func (handler *IAMHandler) GetIdentity(ctx context.Context, request api.GetIdentityRequestObject) (api.GetIdentityResponseObject, error)
- func (handler *IAMHandler) ListCurrentIdentityGroups(ctx context.Context, request api.ListCurrentIdentityGroupsRequestObject) (api.ListCurrentIdentityGroupsResponseObject, error)
- func (handler *IAMHandler) ListCurrentIdentityTokens(ctx context.Context, request api.ListCurrentIdentityTokensRequestObject) (api.ListCurrentIdentityTokensResponseObject, error)
- func (handler *IAMHandler) ListGroupMembers(ctx context.Context, request api.ListGroupMembersRequestObject) (api.ListGroupMembersResponseObject, error)
- func (handler *IAMHandler) ListGroups(ctx context.Context, request api.ListGroupsRequestObject) (api.ListGroupsResponseObject, error)
- func (handler *IAMHandler) ListIdentities(ctx context.Context, request api.ListIdentitiesRequestObject) (api.ListIdentitiesResponseObject, error)
- func (handler *IAMHandler) ListIdentityGroups(ctx context.Context, request api.ListIdentityGroupsRequestObject) (api.ListIdentityGroupsResponseObject, error)
- func (handler *IAMHandler) ListIdentityTokens(ctx context.Context, request api.ListIdentityTokensRequestObject) (api.ListIdentityTokensResponseObject, error)
- func (handler *IAMHandler) RemoveGroupMember(ctx context.Context, request api.RemoveGroupMemberRequestObject) (api.RemoveGroupMemberResponseObject, error)
- func (handler *IAMHandler) RevokeCurrentIdentityToken(ctx context.Context, request api.RevokeCurrentIdentityTokenRequestObject) (api.RevokeCurrentIdentityTokenResponseObject, error)
- func (handler *IAMHandler) RevokeIdentityToken(ctx context.Context, request api.RevokeIdentityTokenRequestObject) (api.RevokeIdentityTokenResponseObject, error)
- func (handler *IAMHandler) UpdateGroup(ctx context.Context, request api.UpdateGroupRequestObject) (api.UpdateGroupResponseObject, error)
- func (handler *IAMHandler) UpdateIdentity(ctx context.Context, request api.UpdateIdentityRequestObject) (api.UpdateIdentityResponseObject, error)
- type IAMStore
- type LifecycleFailureReporter
- type Middleware
- func Authorization(auditor AuthorizationDenialAuditor, failures AuditFailureReporter) Middleware
- func Compatibility(config CompatibilityConfig) Middleware
- func NewBoundary(config BoundaryConfig) (Middleware, error)
- func NewContractValidation(document *openapi3.T) (Middleware, error)
- func RateLimit(limiter RateLimiter) Middleware
- type PowerDNSCompatibility
- type PowerDNSProxy
- func (proxy *PowerDNSProxy) AddToView(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) AxfrExportZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) AxfrRetrieveZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) CacheFlushByName(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) CreateAutoprimary(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) CreateBrowserSession(w http.ResponseWriter, r *http.Request)
- func (proxy *PowerDNSProxy) CreateCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) CreateMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) CreateTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) CreateZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) DeleteAutoprimary(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) DeleteBrowserSession(w http.ResponseWriter, r *http.Request)
- func (proxy *PowerDNSProxy) DeleteCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) DeleteFromView(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) DeleteMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) DeleteTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) DeleteZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) GetAutoprimaries(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) GetConfig(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) GetConfigSetting(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) GetCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) GetMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) GetNetwork(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) GetStats(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) GetTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) ListCryptokeys(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) ListMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) ListNetworks(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) ListServer(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) ListServers(w http.ResponseWriter, request *http.Request)
- func (proxy *PowerDNSProxy) ListTSIGKeys(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) ListView(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) ListViews(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
- func (proxy *PowerDNSProxy) ListZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) ListZones(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) ModifyCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) ModifyMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) NotifyZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) PatchZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) PowerDNSError(w http.ResponseWriter, request *http.Request)
- func (proxy *PowerDNSProxy) PutTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) PutZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) RectifyZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) SearchData(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- func (proxy *PowerDNSProxy) SetNetwork(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ...)
- type Probe
- type RRsetMutationStore
- type RateLimiter
- type RouteInfo
- type ServerConfig
- type ZoneHandler
- func (handler *ZoneHandler) ConfirmZoneBindingAbsent(ctx context.Context, request api.ConfirmZoneBindingAbsentRequestObject) (api.ConfirmZoneBindingAbsentResponseObject, error)
- func (handler *ZoneHandler) CreateZoneBinding(ctx context.Context, request api.CreateZoneBindingRequestObject) (api.CreateZoneBindingResponseObject, error)
- func (handler *ZoneHandler) GetZoneBinding(ctx context.Context, request api.GetZoneBindingRequestObject) (api.GetZoneBindingResponseObject, error)
- func (handler *ZoneHandler) ListZoneBindings(ctx context.Context, request api.ListZoneBindingsRequestObject) (api.ListZoneBindingsResponseObject, error)
- func (handler *ZoneHandler) ObserveZoneBinding(ctx context.Context, request api.ObserveZoneBindingRequestObject) (api.ObserveZoneBindingResponseObject, error)
- func (handler *ZoneHandler) RebindZoneBinding(ctx context.Context, request api.RebindZoneBindingRequestObject) (api.RebindZoneBindingResponseObject, error)
- func (handler *ZoneHandler) RetryZoneBindingDeletion(ctx context.Context, request api.RetryZoneBindingDeletionRequestObject) (api.RetryZoneBindingDeletionResponseObject, error)
- type ZoneLifecycleStore
- type ZoneManagementStore
Constants ¶
const RateLimitBucketHeader = "X-DANS-RateLimit-Bucket"
RateLimitBucketHeader names every bucket that refused a request.
Variables ¶
This section is empty.
Functions ¶
func ActorFromContext ¶
ActorFromContext returns the actor established by Authentication.
func Authentication ¶
func Authentication(authenticator Authenticator) func(http.Handler) http.Handler
Authentication accepts exactly one header token or browser credential. Session creation/deletion handlers establish or clear their own credentials.
func Chain ¶
func Chain(handler http.Handler, middleware ...Middleware) http.Handler
Chain applies middleware in the order listed.
func ContractOperationIDs ¶
ContractOperationIDs returns the canonical operation IDs of the embedded combined contract, as recorded in RouteInfo.
func GracefulShutdown ¶
func GracefulShutdown(parent context.Context, server shutdownServer, health *Health, timeout time.Duration) error
GracefulShutdown marks the instance unready, drains within a fixed deadline, and force-closes any connection left after that deadline.
func ListenAndServe ¶
func ListenAndServe(ctx context.Context, server *http.Server, health *Health, shutdownTimeout time.Duration) error
ListenAndServe binds the configured address before entering Serve, avoiding a cancellation race between listener creation and graceful shutdown.
func NewApplicationHandler ¶
func NewApplicationHandler(config ApplicationConfig) (http.Handler, error)
NewApplicationHandler assembles the production middleware and generated router from the exact embedded public contract.
func NewGeneratedServer ¶
func NewGeneratedServer(strict api.StrictServerInterface) api.ServerInterface
NewGeneratedServer adapts strict generated handlers with secret-safe errors.
func NewHTTPServer ¶
NewHTTPServer creates a server without opening a listener.
func NewJSONLogger ¶
NewJSONLogger returns the sole production log encoding.
func NewRootHandler ¶
NewRootHandler registers the three operations whose OpenAPI server override places them outside the global /api/v1 compatibility base.
func RequestIDFromContext ¶
RequestIDFromContext returns the current request identifier, if assigned.
Types ¶
type AccessMetadata ¶
type AccessMetadata struct {
// contains filtered or unexported fields
}
AccessMetadata is populated by routing, authorization, and forwarding code. It intentionally has no free-form field or request/response payload field.
func AccessMetadataFromContext ¶
func AccessMetadataFromContext(ctx context.Context) *AccessMetadata
AccessMetadataFromContext returns the request's bounded access-log fields.
func (*AccessMetadata) SetActorID ¶
func (metadata *AccessMetadata) SetActorID(actorID string)
func (*AccessMetadata) SetOpaqueIDs ¶
func (metadata *AccessMetadata) SetOpaqueIDs(actorID, resourceID, operationID string)
func (*AccessMetadata) SetOperationID ¶
func (metadata *AccessMetadata) SetOperationID(operationID string)
func (*AccessMetadata) SetRateLimit ¶
func (metadata *AccessMetadata) SetRateLimit(decision ratelimit.Decision)
SetRateLimit records a metered request's rate-limit decision.
func (*AccessMetadata) SetResourceID ¶
func (metadata *AccessMetadata) SetResourceID(resourceID string)
func (*AccessMetadata) SetRoute ¶
func (metadata *AccessMetadata) SetRoute(template, apiOperationID string)
func (*AccessMetadata) SetUpstreamOutcome ¶
func (metadata *AccessMetadata) SetUpstreamOutcome(outcome string)
type ApplicationConfig ¶
type ApplicationConfig struct {
Boundary BoundaryConfig
Logger *slog.Logger
Authenticator Authenticator
BrowserSessions *BrowserSessions
Schema Probe
PowerDNSReady func() bool
Health *Health
Upstream *upstream.Client
DANS DANSOperations
Mutations RRsetMutationStore
Lifecycle ZoneLifecycleStore
Denials AuthorizationDenialAuditor
AuditFailures AuditFailureReporter
LifecycleFailures LifecycleFailureReporter
UpstreamID string
MutationTimeout time.Duration
// RateLimiter is optional; nil leaves rate limiting out of the chain.
RateLimiter RateLimiter
}
ApplicationConfig contains the immutable dependencies of the HTTP trust boundary. DANS supplies the management operations; PowerDNSProxy overrides every upstream operation.
type AuditFailureReporter ¶
type AuditFailureReporter interface {
ReportAuditFailure()
}
AuditFailureReporter makes an instance unready after a terminal audit write fails, without changing an already-observed upstream response.
type AuditHandler ¶
type AuditHandler struct {
api.StrictServerInterface
// contains filtered or unexported fields
}
AuditHandler overrides audit operations and delegates the rest of the generated strict interface.
func NewAuditHandler ¶
func NewAuditHandler(store AuditStore, next api.StrictServerInterface) (*AuditHandler, error)
func (*AuditHandler) ListAuditEvents ¶
func (handler *AuditHandler) ListAuditEvents(ctx context.Context, request api.ListAuditEventsRequestObject) (api.ListAuditEventsResponseObject, error)
type AuditHealth ¶
type AuditHealth struct {
// contains filtered or unexported fields
}
AuditHealth latches a failed terminal audit write and clears it only after a real persistence probe succeeds.
func NewAuditHealth ¶
func NewAuditHealth(recovery Probe) (*AuditHealth, error)
func (*AuditHealth) Failed ¶
func (health *AuditHealth) Failed() bool
func (*AuditHealth) ReportAuditFailure ¶
func (health *AuditHealth) ReportAuditFailure()
func (*AuditHealth) ReportLifecycleFailure ¶
func (health *AuditHealth) ReportLifecycleFailure()
ReportLifecycleFailure latches an upstream-success/local-binding failure. Unlike a transient audit failure, it needs explicit reconciliation and must not be cleared by a successful audit persistence probe.
type AuditStore ¶
type AuditStore interface {
ListAuditEvents(context.Context, database.Actor, database.AuditListOptions) (database.AuditPage, error)
}
AuditStore is the immutable operator audit read surface.
type Authenticator ¶
Authenticator resolves current durable state for one API token or browser secret.
type BoundaryConfig ¶
type BoundaryConfig struct {
MaxBodyBytes int64
RequestTimeout time.Duration
MaxConcurrent int
NewRequestID func() (string, error)
}
BoundaryConfig bounds resources before contract validation or authentication.
type BrowseHandler ¶
type BrowseHandler struct {
api.StrictServerInterface
// contains filtered or unexported fields
}
func NewBrowseHandler ¶
func NewBrowseHandler(store BrowseStore, upstreamID string, next api.StrictServerInterface) (*BrowseHandler, error)
func (*BrowseHandler) BrowseRRsets ¶
func (h *BrowseHandler) BrowseRRsets(ctx context.Context, r api.BrowseRRsetsRequestObject) (api.BrowseRRsetsResponseObject, error)
func (*BrowseHandler) RefreshRRsets ¶
func (h *BrowseHandler) RefreshRRsets(ctx context.Context, r api.RefreshRRsetsRequestObject) (api.RefreshRRsetsResponseObject, error)
type BrowseStore ¶
type BrowseStore interface {
BrowseRRsets(context.Context, database.Actor, string, string, database.BrowseOptions, bool) (database.BrowsePage, error)
}
BrowseStore serves only API-observed DNS data, independently of write grants.
type BrowserSessionStore ¶
type BrowserSessionStore interface {
CreateBrowserSession(context.Context, string, string) (database.CreatedBrowserSession, error)
DeleteBrowserSession(context.Context, string) error
}
BrowserSessionStore persists opaque session digests against current API tokens.
type BrowserSessions ¶
type BrowserSessions struct {
Store BrowserSessionStore
DevelopmentHTTP bool
}
BrowserSessions handles cookie transport separately from generated JSON bodies.
func (*BrowserSessions) Authentication ¶
func (sessions *BrowserSessions) Authentication(authenticator Authenticator) func(http.Handler) http.Handler
Authentication applies the configured cookie transport without changing token validation or cross-origin protection. A nil receiver uses secure cookies.
func (*BrowserSessions) CreateBrowserSession ¶
func (h *BrowserSessions) CreateBrowserSession(w http.ResponseWriter, r *http.Request)
func (*BrowserSessions) DeleteBrowserSession ¶
func (h *BrowserSessions) DeleteBrowserSession(w http.ResponseWriter, r *http.Request)
type CompatibilityConfig ¶
type DANSOperations ¶
type DANSOperations interface {
BrowseRRsets(http.ResponseWriter, *http.Request, string, string, api.BrowseRRsetsParams)
RefreshRRsets(http.ResponseWriter, *http.Request, string, string)
GetAPIDocument(http.ResponseWriter, *http.Request)
ListAuditEvents(http.ResponseWriter, *http.Request, api.ListAuditEventsParams)
ExportAuditEvents(http.ResponseWriter, *http.Request, api.ExportAuditEventsParams)
ListDelegations(http.ResponseWriter, *http.Request, api.ListDelegationsParams)
CreateDelegation(http.ResponseWriter, *http.Request)
RevokeDelegation(http.ResponseWriter, *http.Request, api.DelegationID)
GetDelegation(http.ResponseWriter, *http.Request, api.DelegationID)
ListGroups(http.ResponseWriter, *http.Request, api.ListGroupsParams)
CreateGroup(http.ResponseWriter, *http.Request)
GetGroup(http.ResponseWriter, *http.Request, api.GroupID)
UpdateGroup(http.ResponseWriter, *http.Request, api.GroupID)
ListGroupMembers(http.ResponseWriter, *http.Request, api.GroupID, api.ListGroupMembersParams)
RemoveGroupMember(http.ResponseWriter, *http.Request, api.GroupID, api.IdentityID)
AddGroupMember(http.ResponseWriter, *http.Request, api.GroupID, api.IdentityID)
ListIdentities(http.ResponseWriter, *http.Request, api.ListIdentitiesParams)
CreateIdentity(http.ResponseWriter, *http.Request)
GetIdentity(http.ResponseWriter, *http.Request, api.IdentityID)
UpdateIdentity(http.ResponseWriter, *http.Request, api.IdentityID)
ListIdentityTokens(http.ResponseWriter, *http.Request, api.IdentityID, api.ListIdentityTokensParams)
CreateIdentityToken(http.ResponseWriter, *http.Request, api.IdentityID)
RevokeIdentityToken(http.ResponseWriter, *http.Request, api.IdentityID, api.TokenID)
GetCurrentIdentity(http.ResponseWriter, *http.Request)
GetCurrentCredential(http.ResponseWriter, *http.Request)
ListIdentityGroups(http.ResponseWriter, *http.Request, api.IdentityID, api.ListIdentityGroupsParams)
ListIdentityDelegations(http.ResponseWriter, *http.Request, api.IdentityID, api.ListIdentityDelegationsParams)
ListIdentityAssignments(http.ResponseWriter, *http.Request, api.IdentityID, api.ListIdentityAssignmentsParams)
ListCurrentIdentityDelegations(http.ResponseWriter, *http.Request, api.ListCurrentIdentityDelegationsParams)
ListCurrentIdentityGroups(http.ResponseWriter, *http.Request, api.ListCurrentIdentityGroupsParams)
ListCurrentIdentityTokens(http.ResponseWriter, *http.Request, api.ListCurrentIdentityTokensParams)
CreateCurrentIdentityToken(http.ResponseWriter, *http.Request)
RevokeCurrentIdentityToken(http.ResponseWriter, *http.Request, api.TokenID)
ListZoneBindings(http.ResponseWriter, *http.Request, api.ListZoneBindingsParams)
CreateZoneBinding(http.ResponseWriter, *http.Request)
GetZoneBinding(http.ResponseWriter, *http.Request, api.ZoneBindingID)
ConfirmZoneBindingAbsent(http.ResponseWriter, *http.Request, api.ZoneBindingID)
ObserveZoneBinding(http.ResponseWriter, *http.Request, api.ZoneBindingID)
RebindZoneBinding(http.ResponseWriter, *http.Request, api.ZoneBindingID)
RetryZoneBindingDeletion(http.ResponseWriter, *http.Request, api.ZoneBindingID)
GetLiveness(http.ResponseWriter, *http.Request)
GetReadiness(http.ResponseWriter, *http.Request)
}
DANSOperations is the non-PowerDNS portion of the generated server. Keeping this interface narrow makes the compiler prove that PowerDNSProxy explicitly implements every upstream operation rather than inheriting one by accident.
func NewDANSOperations ¶
func NewDANSOperations(config GeneratedConfig) (DANSOperations, error)
NewDANSOperations builds the complete generated DANS management chain. The returned standard server is embedded by PowerDNSProxy, which owns every compatibility operation explicitly.
type DelegationHandler ¶
type DelegationHandler struct {
api.StrictServerInterface
// contains filtered or unexported fields
}
DelegationHandler overrides delegation operations and delegates every other generated strict operation to the next handler.
func NewDelegationHandler ¶
func NewDelegationHandler(store DelegationStore, next api.StrictServerInterface) (*DelegationHandler, error)
func (*DelegationHandler) CreateDelegation ¶
func (handler *DelegationHandler) CreateDelegation(ctx context.Context, request api.CreateDelegationRequestObject) (api.CreateDelegationResponseObject, error)
func (*DelegationHandler) GetDelegation ¶
func (handler *DelegationHandler) GetDelegation(ctx context.Context, request api.GetDelegationRequestObject) (api.GetDelegationResponseObject, error)
func (*DelegationHandler) ListCurrentIdentityDelegations ¶
func (handler *DelegationHandler) ListCurrentIdentityDelegations(ctx context.Context, request api.ListCurrentIdentityDelegationsRequestObject) (api.ListCurrentIdentityDelegationsResponseObject, error)
func (*DelegationHandler) ListDelegations ¶
func (handler *DelegationHandler) ListDelegations(ctx context.Context, request api.ListDelegationsRequestObject) (api.ListDelegationsResponseObject, error)
func (*DelegationHandler) ListIdentityAssignments ¶
func (handler *DelegationHandler) ListIdentityAssignments(ctx context.Context, request api.ListIdentityAssignmentsRequestObject) (api.ListIdentityAssignmentsResponseObject, error)
func (*DelegationHandler) ListIdentityDelegations ¶
func (handler *DelegationHandler) ListIdentityDelegations(ctx context.Context, request api.ListIdentityDelegationsRequestObject) (api.ListIdentityDelegationsResponseObject, error)
func (*DelegationHandler) RevokeDelegation ¶
func (handler *DelegationHandler) RevokeDelegation(ctx context.Context, request api.RevokeDelegationRequestObject) (api.RevokeDelegationResponseObject, error)
type DelegationStore ¶
type DelegationStore interface {
ListIdentityDelegations(context.Context, database.Actor, string, database.DelegationListOptions) (database.DelegationPage, error)
ListIdentityAssignments(context.Context, database.Actor, string, database.DelegationListOptions) (database.RetainedAssignmentPage, error)
CreateDelegation(context.Context, database.Actor, database.DelegationCreate) (database.DelegationDetails, error)
GetDelegation(context.Context, database.Actor, string) (database.DelegationDetails, error)
ListDelegations(context.Context, database.Actor, database.DelegationListOptions) (database.DelegationPage, error)
ListCurrentIdentityDelegations(context.Context, database.Actor, database.DelegationListOptions) (database.DelegationPage, error)
RevokeDelegation(context.Context, database.Actor, string) error
}
type Dependencies ¶
Dependencies are the four independent readiness requirements.
type GeneratedConfig ¶
type GeneratedConfig struct {
Store *database.Store
Upstream *upstream.Client
UpstreamID string
MutationTimeout time.Duration
AuditFailures AuditFailureReporter
}
GeneratedConfig contains the concrete runtime services shared by every DANS strict handler.
type Health ¶
type Health struct {
// contains filtered or unexported fields
}
Health separates process liveness from current dependency readiness.
func NewHealth ¶
func NewHealth(dependencies Dependencies, timeout time.Duration) (*Health, error)
NewHealth builds an immutable, bounded readiness checker.
func (*Health) BeginDrain ¶
func (health *Health) BeginDrain()
BeginDrain irreversibly makes the instance unready before listener shutdown.
func (*Health) Livez ¶
func (*Health) Livez(w http.ResponseWriter, _ *http.Request)
Livez reports process HTTP liveness without dependency detail.
type IAMHandler ¶
type IAMHandler struct {
api.StrictServerInterface
// contains filtered or unexported fields
}
IAMHandler overrides IAM operations and delegates every other generated strict operation to the next handler.
func NewIAMHandler ¶
func NewIAMHandler(store IAMStore, next api.StrictServerInterface) (*IAMHandler, error)
func (*IAMHandler) AddGroupMember ¶
func (handler *IAMHandler) AddGroupMember(ctx context.Context, request api.AddGroupMemberRequestObject) (api.AddGroupMemberResponseObject, error)
func (*IAMHandler) CreateCurrentIdentityToken ¶
func (handler *IAMHandler) CreateCurrentIdentityToken(ctx context.Context, request api.CreateCurrentIdentityTokenRequestObject) (api.CreateCurrentIdentityTokenResponseObject, error)
func (*IAMHandler) CreateGroup ¶
func (handler *IAMHandler) CreateGroup(ctx context.Context, request api.CreateGroupRequestObject) (api.CreateGroupResponseObject, error)
func (*IAMHandler) CreateIdentity ¶
func (handler *IAMHandler) CreateIdentity(ctx context.Context, request api.CreateIdentityRequestObject) (api.CreateIdentityResponseObject, error)
func (*IAMHandler) CreateIdentityToken ¶
func (handler *IAMHandler) CreateIdentityToken(ctx context.Context, request api.CreateIdentityTokenRequestObject) (api.CreateIdentityTokenResponseObject, error)
func (*IAMHandler) GetCurrentCredential ¶
func (handler *IAMHandler) GetCurrentCredential(ctx context.Context, _ api.GetCurrentCredentialRequestObject) (api.GetCurrentCredentialResponseObject, error)
func (*IAMHandler) GetCurrentIdentity ¶
func (handler *IAMHandler) GetCurrentIdentity(ctx context.Context, _ api.GetCurrentIdentityRequestObject) (api.GetCurrentIdentityResponseObject, error)
func (*IAMHandler) GetGroup ¶
func (handler *IAMHandler) GetGroup(ctx context.Context, request api.GetGroupRequestObject) (api.GetGroupResponseObject, error)
func (*IAMHandler) GetIdentity ¶
func (handler *IAMHandler) GetIdentity(ctx context.Context, request api.GetIdentityRequestObject) (api.GetIdentityResponseObject, error)
func (*IAMHandler) ListCurrentIdentityGroups ¶
func (handler *IAMHandler) ListCurrentIdentityGroups(ctx context.Context, request api.ListCurrentIdentityGroupsRequestObject) (api.ListCurrentIdentityGroupsResponseObject, error)
func (*IAMHandler) ListCurrentIdentityTokens ¶
func (handler *IAMHandler) ListCurrentIdentityTokens(ctx context.Context, request api.ListCurrentIdentityTokensRequestObject) (api.ListCurrentIdentityTokensResponseObject, error)
func (*IAMHandler) ListGroupMembers ¶
func (handler *IAMHandler) ListGroupMembers(ctx context.Context, request api.ListGroupMembersRequestObject) (api.ListGroupMembersResponseObject, error)
func (*IAMHandler) ListGroups ¶
func (handler *IAMHandler) ListGroups(ctx context.Context, request api.ListGroupsRequestObject) (api.ListGroupsResponseObject, error)
func (*IAMHandler) ListIdentities ¶
func (handler *IAMHandler) ListIdentities(ctx context.Context, request api.ListIdentitiesRequestObject) (api.ListIdentitiesResponseObject, error)
func (*IAMHandler) ListIdentityGroups ¶
func (handler *IAMHandler) ListIdentityGroups(ctx context.Context, request api.ListIdentityGroupsRequestObject) (api.ListIdentityGroupsResponseObject, error)
func (*IAMHandler) ListIdentityTokens ¶
func (handler *IAMHandler) ListIdentityTokens(ctx context.Context, request api.ListIdentityTokensRequestObject) (api.ListIdentityTokensResponseObject, error)
func (*IAMHandler) RemoveGroupMember ¶
func (handler *IAMHandler) RemoveGroupMember(ctx context.Context, request api.RemoveGroupMemberRequestObject) (api.RemoveGroupMemberResponseObject, error)
func (*IAMHandler) RevokeCurrentIdentityToken ¶
func (handler *IAMHandler) RevokeCurrentIdentityToken(ctx context.Context, request api.RevokeCurrentIdentityTokenRequestObject) (api.RevokeCurrentIdentityTokenResponseObject, error)
func (*IAMHandler) RevokeIdentityToken ¶
func (handler *IAMHandler) RevokeIdentityToken(ctx context.Context, request api.RevokeIdentityTokenRequestObject) (api.RevokeIdentityTokenResponseObject, error)
func (*IAMHandler) UpdateGroup ¶
func (handler *IAMHandler) UpdateGroup(ctx context.Context, request api.UpdateGroupRequestObject) (api.UpdateGroupResponseObject, error)
func (*IAMHandler) UpdateIdentity ¶
func (handler *IAMHandler) UpdateIdentity(ctx context.Context, request api.UpdateIdentityRequestObject) (api.UpdateIdentityResponseObject, error)
type IAMStore ¶
type IAMStore interface {
CreateIdentity(context.Context, database.Actor, database.IdentityCreate) (database.Identity, error)
GetIdentity(context.Context, database.Actor, string) (database.Identity, error)
ListIdentities(context.Context, database.Actor, database.IdentityListOptions) (database.IdentityPage, error)
PatchIdentity(context.Context, database.Actor, string, database.IdentityPatch) (database.Identity, error)
CreateGroup(context.Context, database.Actor, database.GroupCreate) (database.Group, error)
GetGroup(context.Context, database.Actor, string) (database.Group, error)
ListGroups(context.Context, database.Actor, database.GroupListOptions) (database.GroupPage, error)
PatchGroup(context.Context, database.Actor, string, database.GroupPatch) (database.Group, error)
AddGroupMember(context.Context, database.Actor, string, string) (database.GroupMembership, error)
RemoveGroupMember(context.Context, database.Actor, string, string) error
ListGroupMembers(context.Context, database.Actor, string, database.IdentityListOptions) (database.IdentityPage, error)
ListIdentityGroups(context.Context, database.Actor, string, database.GroupListOptions) (database.GroupPage, error)
ListCurrentIdentityGroups(context.Context, database.Actor, database.GroupListOptions) (database.GroupPage, error)
GetCurrentIdentity(context.Context, database.Actor) (database.Identity, error)
CreateToken(context.Context, database.Actor, string, database.TokenCreate) (database.CreatedToken, error)
ListTokens(context.Context, database.Actor, string, database.TokenListOptions) (database.TokenPage, error)
RevokeToken(context.Context, database.Actor, string, string) error
}
IAMStore is the stable identity, group, membership, and token application service consumed by the generated HTTP handlers.
type LifecycleFailureReporter ¶
type LifecycleFailureReporter interface {
ReportLifecycleFailure()
}
LifecycleFailureReporter latches an upstream-success/local-binding failure until an operator reconciles it and restarts the affected instance.
type Middleware ¶
Middleware is one ordered HTTP trust-boundary stage.
func Authorization ¶
func Authorization(auditor AuthorizationDenialAuditor, failures AuditFailureReporter) Middleware
Authorization enforces route-wide classes. A non-operator delegated write continues to its handler, which authorizes the complete decoded RRset batch.
func Compatibility ¶
func Compatibility(config CompatibilityConfig) Middleware
Compatibility prevents authenticated traffic and sign-in from reaching handlers while the database/schema is unusable, and prevents compatibility requests from reaching an upstream outside the pinned PowerDNS surface.
func NewBoundary ¶
func NewBoundary(config BoundaryConfig) (Middleware, error)
NewBoundary constructs the outer request-ID, recovery, body, deadline, and concurrency stage.
func NewContractValidation ¶
func NewContractValidation(document *openapi3.T) (Middleware, error)
NewContractValidation rejects undeclared or contract-invalid requests before authentication and records the matched operation for later authorization.
func RateLimit ¶
func RateLimit(limiter RateLimiter) Middleware
RateLimit meters authenticated requests after authentication and before compatibility, authorization, audit, and forwarding. Anonymous requests pass through. Admitted and unmetered requests gain no headers.
type PowerDNSCompatibility ¶
type PowerDNSCompatibility struct {
// contains filtered or unexported fields
}
PowerDNSCompatibility records only the latest bounded compatibility probe. It starts fail-closed until the first successful probe.
func (*PowerDNSCompatibility) Compatible ¶
func (state *PowerDNSCompatibility) Compatible() bool
func (*PowerDNSCompatibility) Record ¶
func (state *PowerDNSCompatibility) Record(err error)
type PowerDNSProxy ¶
type PowerDNSProxy struct {
DANSOperations
BrowserSessions *BrowserSessions
Upstream *upstream.Client
Mutations RRsetMutationStore
Lifecycle ZoneLifecycleStore
AuditFailures AuditFailureReporter
LifecycleFailures LifecycleFailureReporter
UpstreamID string
MutationTimeout time.Duration
}
PowerDNSProxy implements every PowerDNS operation through the generated client. The embedded handler supplies only the DANS and root operations.
func (*PowerDNSProxy) AddToView ¶
func (proxy *PowerDNSProxy) AddToView(w http.ResponseWriter, request *http.Request, serverID api.ServerId, view api.View)
func (*PowerDNSProxy) AxfrExportZone ¶
func (proxy *PowerDNSProxy) AxfrExportZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) AxfrRetrieveZone ¶
func (proxy *PowerDNSProxy) AxfrRetrieveZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) CacheFlushByName ¶
func (proxy *PowerDNSProxy) CacheFlushByName(w http.ResponseWriter, request *http.Request, serverID api.ServerId, params api.CacheFlushByNameParams)
func (*PowerDNSProxy) CreateAutoprimary ¶
func (proxy *PowerDNSProxy) CreateAutoprimary(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) CreateBrowserSession ¶
func (proxy *PowerDNSProxy) CreateBrowserSession(w http.ResponseWriter, r *http.Request)
CreateBrowserSession handles the local sign-in operation, never upstream.
func (*PowerDNSProxy) CreateCryptokey ¶
func (proxy *PowerDNSProxy) CreateCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) CreateMetadata ¶
func (proxy *PowerDNSProxy) CreateMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) CreateTSIGKey ¶
func (proxy *PowerDNSProxy) CreateTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) CreateZone ¶
func (proxy *PowerDNSProxy) CreateZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, params api.CreateZoneParams)
func (*PowerDNSProxy) DeleteAutoprimary ¶
func (proxy *PowerDNSProxy) DeleteAutoprimary(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ip, nameserver string)
func (*PowerDNSProxy) DeleteBrowserSession ¶
func (proxy *PowerDNSProxy) DeleteBrowserSession(w http.ResponseWriter, r *http.Request)
DeleteBrowserSession handles the local sign-out operation, never upstream.
func (*PowerDNSProxy) DeleteCryptokey ¶
func (proxy *PowerDNSProxy) DeleteCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId, keyID string)
func (*PowerDNSProxy) DeleteFromView ¶
func (proxy *PowerDNSProxy) DeleteFromView(w http.ResponseWriter, request *http.Request, serverID api.ServerId, view api.View, id string)
func (*PowerDNSProxy) DeleteMetadata ¶
func (proxy *PowerDNSProxy) DeleteMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId, kind string)
func (*PowerDNSProxy) DeleteTSIGKey ¶
func (proxy *PowerDNSProxy) DeleteTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, keyID string)
func (*PowerDNSProxy) DeleteZone ¶
func (proxy *PowerDNSProxy) DeleteZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) GetAutoprimaries ¶
func (proxy *PowerDNSProxy) GetAutoprimaries(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) GetConfig ¶
func (proxy *PowerDNSProxy) GetConfig(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) GetConfigSetting ¶
func (proxy *PowerDNSProxy) GetConfigSetting(w http.ResponseWriter, request *http.Request, serverID api.ServerId, name string)
func (*PowerDNSProxy) GetCryptokey ¶
func (proxy *PowerDNSProxy) GetCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId, keyID string)
func (*PowerDNSProxy) GetMetadata ¶
func (proxy *PowerDNSProxy) GetMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId, kind string)
func (*PowerDNSProxy) GetNetwork ¶
func (proxy *PowerDNSProxy) GetNetwork(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ip, prefixLength string)
func (*PowerDNSProxy) GetStats ¶
func (proxy *PowerDNSProxy) GetStats(w http.ResponseWriter, request *http.Request, serverID api.ServerId, params api.GetStatsParams)
func (*PowerDNSProxy) GetTSIGKey ¶
func (proxy *PowerDNSProxy) GetTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, keyID string)
func (*PowerDNSProxy) ListCryptokeys ¶
func (proxy *PowerDNSProxy) ListCryptokeys(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) ListMetadata ¶
func (proxy *PowerDNSProxy) ListMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) ListNetworks ¶
func (proxy *PowerDNSProxy) ListNetworks(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) ListServer ¶
func (proxy *PowerDNSProxy) ListServer(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) ListServers ¶
func (proxy *PowerDNSProxy) ListServers(w http.ResponseWriter, request *http.Request)
func (*PowerDNSProxy) ListTSIGKeys ¶
func (proxy *PowerDNSProxy) ListTSIGKeys(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) ListView ¶
func (proxy *PowerDNSProxy) ListView(w http.ResponseWriter, request *http.Request, serverID api.ServerId, view api.View)
func (*PowerDNSProxy) ListViews ¶
func (proxy *PowerDNSProxy) ListViews(w http.ResponseWriter, request *http.Request, serverID api.ServerId)
func (*PowerDNSProxy) ListZone ¶
func (proxy *PowerDNSProxy) ListZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId, params api.ListZoneParams)
func (*PowerDNSProxy) ListZones ¶
func (proxy *PowerDNSProxy) ListZones(w http.ResponseWriter, request *http.Request, serverID api.ServerId, params api.ListZonesParams)
func (*PowerDNSProxy) ModifyCryptokey ¶
func (proxy *PowerDNSProxy) ModifyCryptokey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId, keyID string)
func (*PowerDNSProxy) ModifyMetadata ¶
func (proxy *PowerDNSProxy) ModifyMetadata(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId, kind string)
func (*PowerDNSProxy) NotifyZone ¶
func (proxy *PowerDNSProxy) NotifyZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) PatchZone ¶
func (proxy *PowerDNSProxy) PatchZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) PowerDNSError ¶
func (proxy *PowerDNSProxy) PowerDNSError(w http.ResponseWriter, request *http.Request)
func (*PowerDNSProxy) PutTSIGKey ¶
func (proxy *PowerDNSProxy) PutTSIGKey(w http.ResponseWriter, request *http.Request, serverID api.ServerId, keyID string)
func (*PowerDNSProxy) PutZone ¶
func (proxy *PowerDNSProxy) PutZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) RectifyZone ¶
func (proxy *PowerDNSProxy) RectifyZone(w http.ResponseWriter, request *http.Request, serverID api.ServerId, zoneID api.ZoneId)
func (*PowerDNSProxy) SearchData ¶
func (proxy *PowerDNSProxy) SearchData(w http.ResponseWriter, request *http.Request, serverID api.ServerId, params api.SearchDataParams)
func (*PowerDNSProxy) SetNetwork ¶
func (proxy *PowerDNSProxy) SetNetwork(w http.ResponseWriter, request *http.Request, serverID api.ServerId, ip, prefixLength string)
type RRsetMutationStore ¶
type RRsetMutationStore interface {
AuthorizeRRsetBatch(context.Context, string, string, string, string, []database.RRsetTuple) (database.AuthorizationDecision, error)
CreateDNSIntent(context.Context, database.Actor, database.DNSIntentInput) (database.DNSIntent, error)
RecordDNSOutcome(context.Context, database.DNSOutcomeInput) (database.DNSOutcome, error)
}
RRsetMutationStore is the durable decision and audit boundary for a zone patch. The upstream request cannot begin before both authorization and intent persistence succeed.
type RateLimiter ¶
RateLimiter meters one authenticated request. It never fails: backend errors produce an unmetered decision.
type RouteInfo ¶
type RouteInfo struct {
Template string
OperationID string
AccessClass contract.AccessClass
PathParameters map[string]string
}
RouteInfo is the reviewed contract identity of the current request.
type ServerConfig ¶
type ServerConfig struct {
Address string
MaxHeaderBytes int
ReadHeaderTimeout time.Duration
ReadTimeout time.Duration
WriteTimeout time.Duration
IdleTimeout time.Duration
}
ServerConfig fixes the net/http connection-level resource limits.
type ZoneHandler ¶
type ZoneHandler struct {
api.StrictServerInterface
// contains filtered or unexported fields
}
ZoneHandler overrides zone-binding and reconciliation operations and delegates the rest of the generated strict interface.
func NewZoneHandler ¶
func NewZoneHandler(store ZoneManagementStore, client *upstream.Client, upstreamID string, timeout time.Duration, auditFailures AuditFailureReporter, next api.StrictServerInterface) (*ZoneHandler, error)
func (*ZoneHandler) ConfirmZoneBindingAbsent ¶
func (handler *ZoneHandler) ConfirmZoneBindingAbsent(ctx context.Context, request api.ConfirmZoneBindingAbsentRequestObject) (api.ConfirmZoneBindingAbsentResponseObject, error)
func (*ZoneHandler) CreateZoneBinding ¶
func (handler *ZoneHandler) CreateZoneBinding(ctx context.Context, request api.CreateZoneBindingRequestObject) (api.CreateZoneBindingResponseObject, error)
func (*ZoneHandler) GetZoneBinding ¶
func (handler *ZoneHandler) GetZoneBinding(ctx context.Context, request api.GetZoneBindingRequestObject) (api.GetZoneBindingResponseObject, error)
func (*ZoneHandler) ListZoneBindings ¶
func (handler *ZoneHandler) ListZoneBindings(ctx context.Context, request api.ListZoneBindingsRequestObject) (api.ListZoneBindingsResponseObject, error)
func (*ZoneHandler) ObserveZoneBinding ¶
func (handler *ZoneHandler) ObserveZoneBinding(ctx context.Context, request api.ObserveZoneBindingRequestObject) (api.ObserveZoneBindingResponseObject, error)
func (*ZoneHandler) RebindZoneBinding ¶
func (handler *ZoneHandler) RebindZoneBinding(ctx context.Context, request api.RebindZoneBindingRequestObject) (api.RebindZoneBindingResponseObject, error)
func (*ZoneHandler) RetryZoneBindingDeletion ¶
func (handler *ZoneHandler) RetryZoneBindingDeletion(ctx context.Context, request api.RetryZoneBindingDeletionRequestObject) (api.RetryZoneBindingDeletionResponseObject, error)
type ZoneLifecycleStore ¶
type ZoneLifecycleStore interface {
BindCreatedZone(context.Context, database.Actor, database.ZoneBindingInput) (database.ZoneBinding, error)
PrepareZoneDeletionByUpstreamZoneID(context.Context, database.Actor, database.ZoneDeletionByUpstreamInput) (database.ZoneDeletionPlan, error)
RecordZoneDeletionOutcome(context.Context, database.ZoneDeletionPlan, database.ZoneDeletionOutcomeInput) (database.DNSOutcome, error)
}
ZoneLifecycleStore owns the generation changes which must bracket upstream zone creation and deletion.
type ZoneManagementStore ¶
type ZoneManagementStore interface {
EnsureZoneBinding(context.Context, database.Actor, database.ZoneBindingInput) (database.ZoneBinding, error)
GetZoneBindingRecovery(context.Context, database.Actor, string) (database.ZoneBindingRecovery, error)
GetZoneBinding(context.Context, database.Actor, string) (database.ZoneBinding, error)
ListZoneBindings(context.Context, database.Actor, database.ZoneBindingListOptions) (database.ZoneBindingPage, error)
ObserveZoneBinding(context.Context, database.Actor, database.ZoneObservationInput) (database.ZoneObservation, error)
ConfirmZoneBindingAbsent(context.Context, database.Actor, string) (database.ZoneBinding, error)
PrepareZoneDeletionRetry(context.Context, database.Actor, database.ZoneDeletionInput) (database.ZoneDeletionPlan, error)
RecordZoneDeletionOutcome(context.Context, database.ZoneDeletionPlan, database.ZoneDeletionOutcomeInput) (database.DNSOutcome, error)
RebindZoneBinding(context.Context, database.Actor, string, database.ZoneBindingInput) (database.ZoneBinding, error)
}
ZoneManagementStore is the persistence boundary for generation-aware zone binding and explicit deletion reconciliation.