@serve.zone/dcrouter-apiclient 33.0.1 → 34.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist_ts_interfaces/data/dns-authority.d.ts +64 -7
- package/dist_ts_interfaces/data/dns-authority.js +10 -5
- package/dist_ts_interfaces/data/dns-mutation-journal.d.ts +78 -0
- package/dist_ts_interfaces/data/dns-mutation-journal.js +2 -0
- package/dist_ts_interfaces/data/dns-protected-hostname.d.ts +16 -0
- package/dist_ts_interfaces/data/dns-protected-hostname.js +2 -0
- package/dist_ts_interfaces/data/dns-record.d.ts +5 -0
- package/dist_ts_interfaces/data/index.d.ts +2 -0
- package/dist_ts_interfaces/data/index.js +3 -1
- package/dist_ts_interfaces/requests/dns-authority.d.ts +7 -5
- package/dist_ts_interfaces/requests/dns-mutation-journal.d.ts +28 -0
- package/dist_ts_interfaces/requests/dns-mutation-journal.js +2 -0
- package/dist_ts_interfaces/requests/dns-protected-hostnames.d.ts +50 -0
- package/dist_ts_interfaces/requests/dns-protected-hostnames.js +2 -0
- package/dist_ts_interfaces/requests/domains.d.ts +10 -1
- package/dist_ts_interfaces/requests/index.d.ts +2 -0
- package/dist_ts_interfaces/requests/index.js +3 -1
- package/package.json +2 -2
- package/ts_interfaces/data/dns-authority.ts +66 -7
- package/ts_interfaces/data/dns-mutation-journal.ts +96 -0
- package/ts_interfaces/data/dns-protected-hostname.ts +16 -0
- package/ts_interfaces/data/dns-record.ts +5 -0
- package/ts_interfaces/data/index.ts +2 -0
- package/ts_interfaces/requests/dns-authority.ts +7 -5
- package/ts_interfaces/requests/dns-mutation-journal.ts +35 -0
- package/ts_interfaces/requests/dns-protected-hostnames.ts +66 -0
- package/ts_interfaces/requests/domains.ts +10 -1
- package/ts_interfaces/requests/index.ts +2 -0
|
@@ -13,10 +13,15 @@
|
|
|
13
13
|
* The fix is not to make the declared list editable. A list an operator can
|
|
14
14
|
* simply append to is self-assertion, which is precisely the failure mode that
|
|
15
15
|
* let routes claim domains nobody verified we own. Instead a zone earns
|
|
16
|
-
* authority by *proof*: its
|
|
17
|
-
* proof is unforgeable by an ops-API caller — you cannot point
|
|
18
|
-
*
|
|
19
|
-
* is the missing comparison between the two representations.
|
|
16
|
+
* authority by *proof*: its delegation in the parent zone must name our
|
|
17
|
+
* nameservers. That proof is unforgeable by an ops-API caller — you cannot point
|
|
18
|
+
* `example.com`'s delegation at our nameservers unless you actually control the
|
|
19
|
+
* domain — and it is the missing comparison between the two representations.
|
|
20
|
+
*
|
|
21
|
+
* The proof is read from the parent zone's own servers, asked without
|
|
22
|
+
* recursion, never from a recursive resolver: a recursive lookup of a zone
|
|
23
|
+
* delegated to us but not claimed yet reaches our servers, which REFUSE it, so
|
|
24
|
+
* it could never prove the delegation it is supposed to prove.
|
|
20
25
|
*
|
|
21
26
|
* `dnsScopes` is gone entirely. There is exactly one representation of DNS
|
|
22
27
|
* authority now, it lives in the database, and it is the one that carries its
|
|
@@ -37,7 +42,10 @@ export interface IDnsAuthorityZone {
|
|
|
37
42
|
origin: TDnsAuthorityZoneOrigin;
|
|
38
43
|
/** When the delegation proof was observed. */
|
|
39
44
|
verifiedAt?: number;
|
|
40
|
-
/**
|
|
45
|
+
/**
|
|
46
|
+
* The NS set the parent zone's servers delegated the zone to at verification
|
|
47
|
+
* time — the evidence for the proof.
|
|
48
|
+
*/
|
|
41
49
|
observedNameservers?: string[];
|
|
42
50
|
/** Operator who performed the verification. */
|
|
43
51
|
verifiedBy?: string;
|
|
@@ -62,20 +70,69 @@ export interface IDnsAuthoritySettings {
|
|
|
62
70
|
updatedBy: string;
|
|
63
71
|
}
|
|
64
72
|
/**
|
|
65
|
-
* Outcome of a delegation probe.
|
|
73
|
+
* Outcome of a delegation probe, decided by the parent zone's servers alone.
|
|
74
|
+
*
|
|
75
|
+
* - 'delegated': at least two of the parent's servers, reached through at least
|
|
76
|
+
* two different parent nameserver names, gave the identical referral for the
|
|
77
|
+
* zone, and its NS set names at least one of our nameservers. A referral that
|
|
78
|
+
* carries a DS sets `dsPresent`, and such a zone cannot be claimed.
|
|
79
|
+
* - 'not-delegated': the same agreement on a referral that names none of our
|
|
80
|
+
* nameservers, or on an authoritative "no such delegation" (NXDOMAIN or NODATA
|
|
81
|
+
* with the parent's SOA). Also the verdict for an unusable zone name.
|
|
82
|
+
* - 'undeterminable': anything less — a failed lookup, fewer than two
|
|
83
|
+
* conclusive answers, or any disagreement between them.
|
|
66
84
|
*
|
|
67
85
|
* 'undeterminable' is deliberately distinct from 'not-delegated': a resolver
|
|
68
86
|
* timeout is not evidence that a zone is not ours. Conflating them would let a
|
|
69
87
|
* transient network fault revoke authority, turning a blip into an outage.
|
|
70
88
|
*/
|
|
71
89
|
export type TDnsDelegationVerdict = 'delegated' | 'not-delegated' | 'undeterminable';
|
|
90
|
+
/**
|
|
91
|
+
* How the probe classified one parent server's answer to the non-recursive
|
|
92
|
+
* NS query for the zone.
|
|
93
|
+
*
|
|
94
|
+
* - 'referral': RCODE 0, AA=0, an empty answer section, and an authority
|
|
95
|
+
* section whose NS records are all owned by the zone, with an OPT record that
|
|
96
|
+
* echoes DO=1 (otherwise a missing DS would prove nothing).
|
|
97
|
+
* - 'negative': AA=1 NXDOMAIN or NODATA with an empty answer section and the
|
|
98
|
+
* parent zone's SOA in the authority section.
|
|
99
|
+
* - 'inconclusive': everything else, including timeouts, REFUSED, any other
|
|
100
|
+
* AA=1 answer (a server that hosts the parent and the child zone answers for
|
|
101
|
+
* the child instead of referring) and referrals to any other name.
|
|
102
|
+
*/
|
|
103
|
+
export type TDnsDelegationParentOutcome = 'referral' | 'negative' | 'inconclusive';
|
|
104
|
+
/** One parent server's answer to the non-recursive NS query for the zone. */
|
|
105
|
+
export interface IDnsDelegationParentAnswer {
|
|
106
|
+
/** The parent server the probe asked, as `ip:port` (`[ip]:port` for IPv6). */
|
|
107
|
+
server: string;
|
|
108
|
+
/** The parent nameserver name this address belongs to. */
|
|
109
|
+
nameserver: string;
|
|
110
|
+
outcome: TDnsDelegationParentOutcome;
|
|
111
|
+
/** The referral's NS set, lowercased, trailing-dot stripped and sorted (referral only). */
|
|
112
|
+
nameservers?: string[];
|
|
113
|
+
/** Whether the referral carried a DS RRset for the zone (referral only). */
|
|
114
|
+
dsPresent?: boolean;
|
|
115
|
+
detail: string;
|
|
116
|
+
}
|
|
72
117
|
export interface IDnsDelegationProbe {
|
|
73
118
|
zone: string;
|
|
74
119
|
verdict: TDnsDelegationVerdict;
|
|
75
|
-
/**
|
|
120
|
+
/**
|
|
121
|
+
* The NS set the parent zone's servers delegate the zone to, lowercased and
|
|
122
|
+
* trailing-dot stripped; empty when there is no agreed referral.
|
|
123
|
+
*/
|
|
76
124
|
observedNameservers: string[];
|
|
77
125
|
expectedNameservers: string[];
|
|
78
126
|
detail: string;
|
|
127
|
+
/** The parent zone whose servers were asked; absent when it was not found. */
|
|
128
|
+
parentZone?: string;
|
|
129
|
+
/**
|
|
130
|
+
* Whether the agreed referral carried a DS for the zone. Set on a verdict
|
|
131
|
+
* that rests on a referral; a `delegated` zone with a DS cannot be claimed.
|
|
132
|
+
*/
|
|
133
|
+
dsPresent?: boolean;
|
|
134
|
+
/** Every parent server's classified answer, when parent servers were asked. */
|
|
135
|
+
parentAnswers?: IDnsDelegationParentAnswer[];
|
|
79
136
|
}
|
|
80
137
|
/** A disagreement between claimed authority and what is actually true. */
|
|
81
138
|
export type TDnsAuthorityDriftKind =
|
|
@@ -13,14 +13,19 @@
|
|
|
13
13
|
* The fix is not to make the declared list editable. A list an operator can
|
|
14
14
|
* simply append to is self-assertion, which is precisely the failure mode that
|
|
15
15
|
* let routes claim domains nobody verified we own. Instead a zone earns
|
|
16
|
-
* authority by *proof*: its
|
|
17
|
-
* proof is unforgeable by an ops-API caller — you cannot point
|
|
18
|
-
*
|
|
19
|
-
* is the missing comparison between the two representations.
|
|
16
|
+
* authority by *proof*: its delegation in the parent zone must name our
|
|
17
|
+
* nameservers. That proof is unforgeable by an ops-API caller — you cannot point
|
|
18
|
+
* `example.com`'s delegation at our nameservers unless you actually control the
|
|
19
|
+
* domain — and it is the missing comparison between the two representations.
|
|
20
|
+
*
|
|
21
|
+
* The proof is read from the parent zone's own servers, asked without
|
|
22
|
+
* recursion, never from a recursive resolver: a recursive lookup of a zone
|
|
23
|
+
* delegated to us but not claimed yet reaches our servers, which REFUSE it, so
|
|
24
|
+
* it could never prove the delegation it is supposed to prove.
|
|
20
25
|
*
|
|
21
26
|
* `dnsScopes` is gone entirely. There is exactly one representation of DNS
|
|
22
27
|
* authority now, it lives in the database, and it is the one that carries its
|
|
23
28
|
* own evidence.
|
|
24
29
|
*/
|
|
25
30
|
export {};
|
|
26
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
31
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG5zLWF1dGhvcml0eS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2ludGVyZmFjZXMvZGF0YS9kbnMtYXV0aG9yaXR5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBNEJHIn0=
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import type { TDnsRecordType } from './dns-record.js';
|
|
2
|
+
/**
|
|
3
|
+
* Who changed DNS state.
|
|
4
|
+
*
|
|
5
|
+
* - 'operator' → a person through the ops API.
|
|
6
|
+
* - 'automation' → a dcrouter reconciler, named by its `managedBy` namespace.
|
|
7
|
+
* - 'provider' → a change dcrouter observed at a DNS provider while mirroring its zone.
|
|
8
|
+
*/
|
|
9
|
+
export type TDnsMutationActorKind = 'operator' | 'automation' | 'provider';
|
|
10
|
+
/**
|
|
11
|
+
* What a journal entry records.
|
|
12
|
+
*
|
|
13
|
+
* Record mutations: 'create', 'update', 'delete'. Ownership changes that leave the record's
|
|
14
|
+
* DNS data alone: 'release' (an owned record loses its owner and becomes an operator record),
|
|
15
|
+
* 'handoff' (an owned record moves to another owner of the same namespace). Provider
|
|
16
|
+
* observations: 'mirror-update' and 'mirror-delete' (the local mirror follows a change made at
|
|
17
|
+
* the provider). Migration to a provider: 'link' (a local record is linked to the provider record
|
|
18
|
+
* the migration created for it), 'adopt' (a local record is linked to the identical record the
|
|
19
|
+
* target zone already held) and 'migrate' (the zone switches to the provider). Protected-hostname
|
|
20
|
+
* list changes: 'protect', 'unprotect'.
|
|
21
|
+
*/
|
|
22
|
+
export type TDnsMutationOperation = 'create' | 'update' | 'delete' | 'adopt' | 'release' | 'handoff' | 'mirror-update' | 'mirror-delete' | 'link' | 'migrate' | 'protect' | 'unprotect';
|
|
23
|
+
/**
|
|
24
|
+
* - 'pending' → the intent was written and the mutation has not reported back. A pending entry
|
|
25
|
+
* that never completes marks a mutation interrupted between its provider call and its local
|
|
26
|
+
* write (for a provider observation: between the entry and the mirror write).
|
|
27
|
+
* - 'applied' → the mutation took effect.
|
|
28
|
+
* - 'failed' → the mutation ran and failed; nothing it reports as failed took effect. For a
|
|
29
|
+
* provider observation: the mirror did not follow because the record changed in between.
|
|
30
|
+
* - 'refused' → the mutation never ran (protected hostname, or a record the actor does not own).
|
|
31
|
+
* - 'observed' → a provider-side change the local mirror followed while mirroring the zone.
|
|
32
|
+
*/
|
|
33
|
+
export type TDnsMutationOutcome = 'pending' | 'applied' | 'failed' | 'refused' | 'observed';
|
|
34
|
+
/** The DNS data and ownership of one record before or after a mutation. */
|
|
35
|
+
export interface IDnsMutationRecordState {
|
|
36
|
+
name: string;
|
|
37
|
+
type: TDnsRecordType;
|
|
38
|
+
value: string;
|
|
39
|
+
ttl: number;
|
|
40
|
+
proxied?: boolean;
|
|
41
|
+
managedBy?: string;
|
|
42
|
+
managedOwnerId?: string;
|
|
43
|
+
managedRecordKey?: string;
|
|
44
|
+
providerRecordId?: string;
|
|
45
|
+
}
|
|
46
|
+
/** One durable DNS mutation journal entry. Entries are kept for 180 days. */
|
|
47
|
+
export interface IDnsMutationJournalEntry {
|
|
48
|
+
id: string;
|
|
49
|
+
/** When the intent (or the refusal or observation) was written, Unix epoch milliseconds. */
|
|
50
|
+
createdAt: number;
|
|
51
|
+
/** When the outcome was written; absent while `outcome` is 'pending'. */
|
|
52
|
+
completedAt?: number;
|
|
53
|
+
operation: TDnsMutationOperation;
|
|
54
|
+
outcome: TDnsMutationOutcome;
|
|
55
|
+
actorKind: TDnsMutationActorKind;
|
|
56
|
+
/** Operator user id, automation namespace (`managedBy`) or provider id. */
|
|
57
|
+
actor: string;
|
|
58
|
+
/** What started the mutation, e.g. 'ops-api', 'gateway-route-sync', 'orphan-prune', 'provider-sync'. */
|
|
59
|
+
trigger: string;
|
|
60
|
+
/** Why, in words. */
|
|
61
|
+
reason: string;
|
|
62
|
+
/** Owner within the actor's namespace on whose behalf the mutation ran. */
|
|
63
|
+
ownerId?: string;
|
|
64
|
+
domainId?: string;
|
|
65
|
+
zoneName?: string;
|
|
66
|
+
/** Canonical hostname (lowercase, no trailing dot) the entry concerns. */
|
|
67
|
+
hostname: string;
|
|
68
|
+
recordId?: string;
|
|
69
|
+
before?: IDnsMutationRecordState;
|
|
70
|
+
after?: IDnsMutationRecordState;
|
|
71
|
+
/** Failure or refusal detail. */
|
|
72
|
+
message?: string;
|
|
73
|
+
}
|
|
74
|
+
/** Stable seek position for descending journal pages. */
|
|
75
|
+
export interface IDnsMutationJournalCursor {
|
|
76
|
+
createdAt: number;
|
|
77
|
+
id: string;
|
|
78
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A hostname no dcrouter automation may change.
|
|
3
|
+
*
|
|
4
|
+
* Every dcrouter automation that writes DNS records (route DNS, the gateway-client hostname
|
|
5
|
+
* manager, the mail DNS reconciler, migration to a DNS provider) is refused every create, update, delete, adoption and owner
|
|
6
|
+
* handoff of any record type at this exact name; it may only release its ownership of a record
|
|
7
|
+
* there, which leaves the record in place as an operator record. Operator changes through the
|
|
8
|
+
* ops API are not bound. Provider zone mirroring still records what the provider holds.
|
|
9
|
+
*/
|
|
10
|
+
export interface IDnsProtectedHostname {
|
|
11
|
+
/** Exact hostname: lowercase, no trailing dot, no wildcard. Subdomains are not covered. */
|
|
12
|
+
hostname: string;
|
|
13
|
+
reason: string;
|
|
14
|
+
createdBy: string;
|
|
15
|
+
createdAt: number;
|
|
16
|
+
}
|
|
@@ -45,4 +45,9 @@ export interface IDnsRecord {
|
|
|
45
45
|
managedOwnerId?: string;
|
|
46
46
|
/** Deterministic record identity. Unique only when present. */
|
|
47
47
|
managedRecordKey?: string;
|
|
48
|
+
/**
|
|
49
|
+
* True when the record's name is on the protected-hostname list (see
|
|
50
|
+
* `IDnsProtectedHostname`): no automation may change it. Absent otherwise.
|
|
51
|
+
*/
|
|
52
|
+
protectedHostname?: true;
|
|
48
53
|
}
|
|
@@ -9,6 +9,8 @@ export * from './domain.js';
|
|
|
9
9
|
export * from './dns-authority.js';
|
|
10
10
|
export * from './workhoster.js';
|
|
11
11
|
export * from './dns-record.js';
|
|
12
|
+
export * from './dns-mutation-journal.js';
|
|
13
|
+
export * from './dns-protected-hostname.js';
|
|
12
14
|
export * from './acme-config.js';
|
|
13
15
|
export * from './email-domain.js';
|
|
14
16
|
export * from './email-settings.js';
|
|
@@ -9,6 +9,8 @@ export * from './domain.js';
|
|
|
9
9
|
export * from './dns-authority.js';
|
|
10
10
|
export * from './workhoster.js';
|
|
11
11
|
export * from './dns-record.js';
|
|
12
|
+
export * from './dns-mutation-journal.js';
|
|
13
|
+
export * from './dns-protected-hostname.js';
|
|
12
14
|
export * from './acme-config.js';
|
|
13
15
|
export * from './email-domain.js';
|
|
14
16
|
export * from './email-settings.js';
|
|
@@ -16,4 +18,4 @@ export * from './smtp-account.js';
|
|
|
16
18
|
export * from './security-policy.js';
|
|
17
19
|
export * from './config-events.js';
|
|
18
20
|
export * from './testing.js';
|
|
19
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
21
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL2RhdGEvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxXQUFXLENBQUM7QUFDMUIsY0FBYyxZQUFZLENBQUM7QUFDM0IsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLHVCQUF1QixDQUFDO0FBQ3RDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxVQUFVLENBQUM7QUFDekIsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLDJCQUEyQixDQUFDO0FBQzFDLGNBQWMsNkJBQTZCLENBQUM7QUFDNUMsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxjQUFjLENBQUMifQ==
|
|
@@ -12,8 +12,9 @@ export interface IReq_GetDnsAuthority extends plugins.typedrequestInterfaces.imp
|
|
|
12
12
|
};
|
|
13
13
|
}
|
|
14
14
|
/**
|
|
15
|
-
* Probe a zone's
|
|
16
|
-
* see the evidence
|
|
15
|
+
* Probe a zone's delegation in its parent zone without changing anything. Lets
|
|
16
|
+
* an operator see the evidence (the parent zone and each parent server's
|
|
17
|
+
* answer) before claiming authority.
|
|
17
18
|
*/
|
|
18
19
|
export interface IReq_ProbeDnsAuthorityZone extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ProbeDnsAuthorityZone> {
|
|
19
20
|
method: 'probeDnsAuthorityZone';
|
|
@@ -27,9 +28,10 @@ export interface IReq_ProbeDnsAuthorityZone extends plugins.typedrequestInterfac
|
|
|
27
28
|
};
|
|
28
29
|
}
|
|
29
30
|
/**
|
|
30
|
-
* Claim authority over a zone. Succeeds only
|
|
31
|
-
*
|
|
32
|
-
*
|
|
31
|
+
* Claim authority over a zone. Succeeds only on a `delegated` probe without a
|
|
32
|
+
* DS: the parent zone's servers agree that the zone is delegated to our
|
|
33
|
+
* nameservers and publish no DS for it. The claim is then persisted and
|
|
34
|
+
* reconciled in-process, with no restart.
|
|
33
35
|
*/
|
|
34
36
|
export interface IReq_VerifyDnsAuthorityZone extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_VerifyDnsAuthorityZone> {
|
|
35
37
|
method: 'verifyDnsAuthorityZone';
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import * as plugins from '../plugins.js';
|
|
2
|
+
import type * as authInterfaces from '../data/auth.js';
|
|
3
|
+
import type { IDnsMutationJournalCursor, IDnsMutationJournalEntry } from '../data/dns-mutation-journal.js';
|
|
4
|
+
/**
|
|
5
|
+
* Read the DNS mutation journal, newest first. Every filter is optional and they combine.
|
|
6
|
+
*/
|
|
7
|
+
export interface IReq_GetDnsMutationJournal extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetDnsMutationJournal> {
|
|
8
|
+
method: 'getDnsMutationJournal';
|
|
9
|
+
request: {
|
|
10
|
+
identity?: authInterfaces.IIdentity;
|
|
11
|
+
apiToken?: string;
|
|
12
|
+
/** Exact hostname; compared lowercase without a trailing dot. */
|
|
13
|
+
hostname?: string;
|
|
14
|
+
/** Zone name, e.g. 'example.com'. */
|
|
15
|
+
zoneName?: string;
|
|
16
|
+
/** Entries written at or after this time, Unix epoch milliseconds. */
|
|
17
|
+
since?: number;
|
|
18
|
+
/** Entries written at or before this time, Unix epoch milliseconds. */
|
|
19
|
+
until?: number;
|
|
20
|
+
/** Page size, 1 to 200; 100 when omitted. */
|
|
21
|
+
limit?: number;
|
|
22
|
+
cursor?: IDnsMutationJournalCursor;
|
|
23
|
+
};
|
|
24
|
+
response: {
|
|
25
|
+
entries: IDnsMutationJournalEntry[];
|
|
26
|
+
nextCursor?: IDnsMutationJournalCursor;
|
|
27
|
+
};
|
|
28
|
+
}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import * as plugins from '../plugins.js';
|
|
2
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG5zLW11dGF0aW9uLWpvdXJuYWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL2Rucy1tdXRhdGlvbi1qb3VybmFsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDIn0=
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import * as plugins from '../plugins.js';
|
|
2
|
+
import type * as authInterfaces from '../data/auth.js';
|
|
3
|
+
import type { IDnsProtectedHostname } from '../data/dns-protected-hostname.js';
|
|
4
|
+
/**
|
|
5
|
+
* List the hostnames no automation may change. Requires an admin identity or an admin API token.
|
|
6
|
+
*/
|
|
7
|
+
export interface IReq_GetDnsProtectedHostnames extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetDnsProtectedHostnames> {
|
|
8
|
+
method: 'getDnsProtectedHostnames';
|
|
9
|
+
request: {
|
|
10
|
+
identity?: authInterfaces.IIdentity;
|
|
11
|
+
apiToken?: string;
|
|
12
|
+
};
|
|
13
|
+
response: {
|
|
14
|
+
hostnames: IDnsProtectedHostname[];
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Protect one exact hostname. Requires an admin identity or an admin API token. The hostname is
|
|
19
|
+
* stored lowercase without a trailing dot; a wildcard is refused. Adding a hostname that is
|
|
20
|
+
* already protected changes nothing and answers success.
|
|
21
|
+
*/
|
|
22
|
+
export interface IReq_AddDnsProtectedHostname extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_AddDnsProtectedHostname> {
|
|
23
|
+
method: 'addDnsProtectedHostname';
|
|
24
|
+
request: {
|
|
25
|
+
identity?: authInterfaces.IIdentity;
|
|
26
|
+
apiToken?: string;
|
|
27
|
+
hostname: string;
|
|
28
|
+
reason: string;
|
|
29
|
+
};
|
|
30
|
+
response: {
|
|
31
|
+
success: boolean;
|
|
32
|
+
hostname?: IDnsProtectedHostname;
|
|
33
|
+
message?: string;
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Remove one hostname from the protected list. Requires an admin identity or an admin API token.
|
|
38
|
+
*/
|
|
39
|
+
export interface IReq_RemoveDnsProtectedHostname extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_RemoveDnsProtectedHostname> {
|
|
40
|
+
method: 'removeDnsProtectedHostname';
|
|
41
|
+
request: {
|
|
42
|
+
identity?: authInterfaces.IIdentity;
|
|
43
|
+
apiToken?: string;
|
|
44
|
+
hostname: string;
|
|
45
|
+
};
|
|
46
|
+
response: {
|
|
47
|
+
success: boolean;
|
|
48
|
+
message?: string;
|
|
49
|
+
};
|
|
50
|
+
}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import * as plugins from '../plugins.js';
|
|
2
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG5zLXByb3RlY3RlZC1ob3N0bmFtZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL2Rucy1wcm90ZWN0ZWQtaG9zdG5hbWVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDIn0=
|
|
@@ -119,6 +119,12 @@ export interface IReq_SyncDomain extends plugins.typedrequestInterfaces.implemen
|
|
|
119
119
|
/**
|
|
120
120
|
* Migrate a domain between dcrouter-hosted and provider-managed (or between providers).
|
|
121
121
|
* Records are transferred to the target and the domain source/providerId are updated.
|
|
122
|
+
*
|
|
123
|
+
* A migration to a provider reads the target zone first and refuses, with
|
|
124
|
+
* nothing written, when a record there conflicts with a migrated record;
|
|
125
|
+
* identical target records are adopted. A failed create rolls back exactly the
|
|
126
|
+
* records the run created. Records at the target that the migration did not
|
|
127
|
+
* create are never changed or deleted.
|
|
122
128
|
*/
|
|
123
129
|
export interface IReq_MigrateDomain extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_MigrateDomain> {
|
|
124
130
|
method: 'migrateDomain';
|
|
@@ -130,7 +136,10 @@ export interface IReq_MigrateDomain extends plugins.typedrequestInterfaces.imple
|
|
|
130
136
|
targetSource: import('../data/domain.js').TDomainSource;
|
|
131
137
|
/** Required when targetSource is 'provider'. */
|
|
132
138
|
targetProviderId?: string;
|
|
133
|
-
/**
|
|
139
|
+
/**
|
|
140
|
+
* @deprecated Refused when `true`: a migration never deletes records at the
|
|
141
|
+
* provider that it did not create. Omit it or send `false`.
|
|
142
|
+
*/
|
|
134
143
|
deleteExistingProviderRecords?: boolean;
|
|
135
144
|
};
|
|
136
145
|
response: {
|
|
@@ -18,6 +18,8 @@ export * from './dns-providers.js';
|
|
|
18
18
|
export * from './domains.js';
|
|
19
19
|
export * from './dns-authority.js';
|
|
20
20
|
export * from './dns-records.js';
|
|
21
|
+
export * from './dns-protected-hostnames.js';
|
|
22
|
+
export * from './dns-mutation-journal.js';
|
|
21
23
|
export * from './acme-config.js';
|
|
22
24
|
export * from './email-domains.js';
|
|
23
25
|
export * from './email-settings.js';
|
|
@@ -18,6 +18,8 @@ export * from './dns-providers.js';
|
|
|
18
18
|
export * from './domains.js';
|
|
19
19
|
export * from './dns-authority.js';
|
|
20
20
|
export * from './dns-records.js';
|
|
21
|
+
export * from './dns-protected-hostnames.js';
|
|
22
|
+
export * from './dns-mutation-journal.js';
|
|
21
23
|
export * from './acme-config.js';
|
|
22
24
|
export * from './email-domains.js';
|
|
23
25
|
export * from './email-settings.js';
|
|
@@ -27,4 +29,4 @@ export * from './workhoster.js';
|
|
|
27
29
|
export * from './security-policy.js';
|
|
28
30
|
export * from './config-events.js';
|
|
29
31
|
export * from './testing.js';
|
|
30
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
32
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsV0FBVyxDQUFDO0FBQzFCLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsVUFBVSxDQUFDO0FBQ3pCLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsOEJBQThCLENBQUM7QUFDN0MsY0FBYywyQkFBMkIsQ0FBQztBQUMxQyxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsY0FBYyxDQUFDIn0=
|
package/package.json
CHANGED
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"MAC authentication"
|
|
29
29
|
],
|
|
30
30
|
"name": "@serve.zone/dcrouter-apiclient",
|
|
31
|
-
"version": "
|
|
31
|
+
"version": "34.1.0",
|
|
32
32
|
"type": "module",
|
|
33
33
|
"description": "Object-oriented TypeScript client and shared TypedRequest contracts for the dcrouter OpsServer API.",
|
|
34
34
|
"main": "./dist_ts_apiclient/index.js",
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
"@push.rocks/smartmta": "^13.0.1",
|
|
52
52
|
"@push.rocks/smartnetwork": "^4.10.1",
|
|
53
53
|
"@push.rocks/smartproxy": "^27.22.0",
|
|
54
|
-
"@serve.zone/interfaces": "^32.
|
|
54
|
+
"@serve.zone/interfaces": "^32.61.0"
|
|
55
55
|
},
|
|
56
56
|
"engines": {
|
|
57
57
|
"node": ">=22.12.0"
|
|
@@ -13,10 +13,15 @@
|
|
|
13
13
|
* The fix is not to make the declared list editable. A list an operator can
|
|
14
14
|
* simply append to is self-assertion, which is precisely the failure mode that
|
|
15
15
|
* let routes claim domains nobody verified we own. Instead a zone earns
|
|
16
|
-
* authority by *proof*: its
|
|
17
|
-
* proof is unforgeable by an ops-API caller — you cannot point
|
|
18
|
-
*
|
|
19
|
-
* is the missing comparison between the two representations.
|
|
16
|
+
* authority by *proof*: its delegation in the parent zone must name our
|
|
17
|
+
* nameservers. That proof is unforgeable by an ops-API caller — you cannot point
|
|
18
|
+
* `example.com`'s delegation at our nameservers unless you actually control the
|
|
19
|
+
* domain — and it is the missing comparison between the two representations.
|
|
20
|
+
*
|
|
21
|
+
* The proof is read from the parent zone's own servers, asked without
|
|
22
|
+
* recursion, never from a recursive resolver: a recursive lookup of a zone
|
|
23
|
+
* delegated to us but not claimed yet reaches our servers, which REFUSE it, so
|
|
24
|
+
* it could never prove the delegation it is supposed to prove.
|
|
20
25
|
*
|
|
21
26
|
* `dnsScopes` is gone entirely. There is exactly one representation of DNS
|
|
22
27
|
* authority now, it lives in the database, and it is the one that carries its
|
|
@@ -39,7 +44,10 @@ export interface IDnsAuthorityZone {
|
|
|
39
44
|
origin: TDnsAuthorityZoneOrigin;
|
|
40
45
|
/** When the delegation proof was observed. */
|
|
41
46
|
verifiedAt?: number;
|
|
42
|
-
/**
|
|
47
|
+
/**
|
|
48
|
+
* The NS set the parent zone's servers delegated the zone to at verification
|
|
49
|
+
* time — the evidence for the proof.
|
|
50
|
+
*/
|
|
43
51
|
observedNameservers?: string[];
|
|
44
52
|
/** Operator who performed the verification. */
|
|
45
53
|
verifiedBy?: string;
|
|
@@ -67,7 +75,17 @@ export interface IDnsAuthoritySettings {
|
|
|
67
75
|
}
|
|
68
76
|
|
|
69
77
|
/**
|
|
70
|
-
* Outcome of a delegation probe.
|
|
78
|
+
* Outcome of a delegation probe, decided by the parent zone's servers alone.
|
|
79
|
+
*
|
|
80
|
+
* - 'delegated': at least two of the parent's servers, reached through at least
|
|
81
|
+
* two different parent nameserver names, gave the identical referral for the
|
|
82
|
+
* zone, and its NS set names at least one of our nameservers. A referral that
|
|
83
|
+
* carries a DS sets `dsPresent`, and such a zone cannot be claimed.
|
|
84
|
+
* - 'not-delegated': the same agreement on a referral that names none of our
|
|
85
|
+
* nameservers, or on an authoritative "no such delegation" (NXDOMAIN or NODATA
|
|
86
|
+
* with the parent's SOA). Also the verdict for an unusable zone name.
|
|
87
|
+
* - 'undeterminable': anything less — a failed lookup, fewer than two
|
|
88
|
+
* conclusive answers, or any disagreement between them.
|
|
71
89
|
*
|
|
72
90
|
* 'undeterminable' is deliberately distinct from 'not-delegated': a resolver
|
|
73
91
|
* timeout is not evidence that a zone is not ours. Conflating them would let a
|
|
@@ -75,13 +93,54 @@ export interface IDnsAuthoritySettings {
|
|
|
75
93
|
*/
|
|
76
94
|
export type TDnsDelegationVerdict = 'delegated' | 'not-delegated' | 'undeterminable';
|
|
77
95
|
|
|
96
|
+
/**
|
|
97
|
+
* How the probe classified one parent server's answer to the non-recursive
|
|
98
|
+
* NS query for the zone.
|
|
99
|
+
*
|
|
100
|
+
* - 'referral': RCODE 0, AA=0, an empty answer section, and an authority
|
|
101
|
+
* section whose NS records are all owned by the zone, with an OPT record that
|
|
102
|
+
* echoes DO=1 (otherwise a missing DS would prove nothing).
|
|
103
|
+
* - 'negative': AA=1 NXDOMAIN or NODATA with an empty answer section and the
|
|
104
|
+
* parent zone's SOA in the authority section.
|
|
105
|
+
* - 'inconclusive': everything else, including timeouts, REFUSED, any other
|
|
106
|
+
* AA=1 answer (a server that hosts the parent and the child zone answers for
|
|
107
|
+
* the child instead of referring) and referrals to any other name.
|
|
108
|
+
*/
|
|
109
|
+
export type TDnsDelegationParentOutcome = 'referral' | 'negative' | 'inconclusive';
|
|
110
|
+
|
|
111
|
+
/** One parent server's answer to the non-recursive NS query for the zone. */
|
|
112
|
+
export interface IDnsDelegationParentAnswer {
|
|
113
|
+
/** The parent server the probe asked, as `ip:port` (`[ip]:port` for IPv6). */
|
|
114
|
+
server: string;
|
|
115
|
+
/** The parent nameserver name this address belongs to. */
|
|
116
|
+
nameserver: string;
|
|
117
|
+
outcome: TDnsDelegationParentOutcome;
|
|
118
|
+
/** The referral's NS set, lowercased, trailing-dot stripped and sorted (referral only). */
|
|
119
|
+
nameservers?: string[];
|
|
120
|
+
/** Whether the referral carried a DS RRset for the zone (referral only). */
|
|
121
|
+
dsPresent?: boolean;
|
|
122
|
+
detail: string;
|
|
123
|
+
}
|
|
124
|
+
|
|
78
125
|
export interface IDnsDelegationProbe {
|
|
79
126
|
zone: string;
|
|
80
127
|
verdict: TDnsDelegationVerdict;
|
|
81
|
-
/**
|
|
128
|
+
/**
|
|
129
|
+
* The NS set the parent zone's servers delegate the zone to, lowercased and
|
|
130
|
+
* trailing-dot stripped; empty when there is no agreed referral.
|
|
131
|
+
*/
|
|
82
132
|
observedNameservers: string[];
|
|
83
133
|
expectedNameservers: string[];
|
|
84
134
|
detail: string;
|
|
135
|
+
/** The parent zone whose servers were asked; absent when it was not found. */
|
|
136
|
+
parentZone?: string;
|
|
137
|
+
/**
|
|
138
|
+
* Whether the agreed referral carried a DS for the zone. Set on a verdict
|
|
139
|
+
* that rests on a referral; a `delegated` zone with a DS cannot be claimed.
|
|
140
|
+
*/
|
|
141
|
+
dsPresent?: boolean;
|
|
142
|
+
/** Every parent server's classified answer, when parent servers were asked. */
|
|
143
|
+
parentAnswers?: IDnsDelegationParentAnswer[];
|
|
85
144
|
}
|
|
86
145
|
|
|
87
146
|
/** A disagreement between claimed authority and what is actually true. */
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import type { TDnsRecordType } from './dns-record.js';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Who changed DNS state.
|
|
5
|
+
*
|
|
6
|
+
* - 'operator' → a person through the ops API.
|
|
7
|
+
* - 'automation' → a dcrouter reconciler, named by its `managedBy` namespace.
|
|
8
|
+
* - 'provider' → a change dcrouter observed at a DNS provider while mirroring its zone.
|
|
9
|
+
*/
|
|
10
|
+
export type TDnsMutationActorKind = 'operator' | 'automation' | 'provider';
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* What a journal entry records.
|
|
14
|
+
*
|
|
15
|
+
* Record mutations: 'create', 'update', 'delete'. Ownership changes that leave the record's
|
|
16
|
+
* DNS data alone: 'release' (an owned record loses its owner and becomes an operator record),
|
|
17
|
+
* 'handoff' (an owned record moves to another owner of the same namespace). Provider
|
|
18
|
+
* observations: 'mirror-update' and 'mirror-delete' (the local mirror follows a change made at
|
|
19
|
+
* the provider). Migration to a provider: 'link' (a local record is linked to the provider record
|
|
20
|
+
* the migration created for it), 'adopt' (a local record is linked to the identical record the
|
|
21
|
+
* target zone already held) and 'migrate' (the zone switches to the provider). Protected-hostname
|
|
22
|
+
* list changes: 'protect', 'unprotect'.
|
|
23
|
+
*/
|
|
24
|
+
export type TDnsMutationOperation =
|
|
25
|
+
| 'create'
|
|
26
|
+
| 'update'
|
|
27
|
+
| 'delete'
|
|
28
|
+
| 'adopt'
|
|
29
|
+
| 'release'
|
|
30
|
+
| 'handoff'
|
|
31
|
+
| 'mirror-update'
|
|
32
|
+
| 'mirror-delete'
|
|
33
|
+
| 'link'
|
|
34
|
+
| 'migrate'
|
|
35
|
+
| 'protect'
|
|
36
|
+
| 'unprotect';
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* - 'pending' → the intent was written and the mutation has not reported back. A pending entry
|
|
40
|
+
* that never completes marks a mutation interrupted between its provider call and its local
|
|
41
|
+
* write (for a provider observation: between the entry and the mirror write).
|
|
42
|
+
* - 'applied' → the mutation took effect.
|
|
43
|
+
* - 'failed' → the mutation ran and failed; nothing it reports as failed took effect. For a
|
|
44
|
+
* provider observation: the mirror did not follow because the record changed in between.
|
|
45
|
+
* - 'refused' → the mutation never ran (protected hostname, or a record the actor does not own).
|
|
46
|
+
* - 'observed' → a provider-side change the local mirror followed while mirroring the zone.
|
|
47
|
+
*/
|
|
48
|
+
export type TDnsMutationOutcome = 'pending' | 'applied' | 'failed' | 'refused' | 'observed';
|
|
49
|
+
|
|
50
|
+
/** The DNS data and ownership of one record before or after a mutation. */
|
|
51
|
+
export interface IDnsMutationRecordState {
|
|
52
|
+
name: string;
|
|
53
|
+
type: TDnsRecordType;
|
|
54
|
+
value: string;
|
|
55
|
+
ttl: number;
|
|
56
|
+
proxied?: boolean;
|
|
57
|
+
managedBy?: string;
|
|
58
|
+
managedOwnerId?: string;
|
|
59
|
+
managedRecordKey?: string;
|
|
60
|
+
providerRecordId?: string;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** One durable DNS mutation journal entry. Entries are kept for 180 days. */
|
|
64
|
+
export interface IDnsMutationJournalEntry {
|
|
65
|
+
id: string;
|
|
66
|
+
/** When the intent (or the refusal or observation) was written, Unix epoch milliseconds. */
|
|
67
|
+
createdAt: number;
|
|
68
|
+
/** When the outcome was written; absent while `outcome` is 'pending'. */
|
|
69
|
+
completedAt?: number;
|
|
70
|
+
operation: TDnsMutationOperation;
|
|
71
|
+
outcome: TDnsMutationOutcome;
|
|
72
|
+
actorKind: TDnsMutationActorKind;
|
|
73
|
+
/** Operator user id, automation namespace (`managedBy`) or provider id. */
|
|
74
|
+
actor: string;
|
|
75
|
+
/** What started the mutation, e.g. 'ops-api', 'gateway-route-sync', 'orphan-prune', 'provider-sync'. */
|
|
76
|
+
trigger: string;
|
|
77
|
+
/** Why, in words. */
|
|
78
|
+
reason: string;
|
|
79
|
+
/** Owner within the actor's namespace on whose behalf the mutation ran. */
|
|
80
|
+
ownerId?: string;
|
|
81
|
+
domainId?: string;
|
|
82
|
+
zoneName?: string;
|
|
83
|
+
/** Canonical hostname (lowercase, no trailing dot) the entry concerns. */
|
|
84
|
+
hostname: string;
|
|
85
|
+
recordId?: string;
|
|
86
|
+
before?: IDnsMutationRecordState;
|
|
87
|
+
after?: IDnsMutationRecordState;
|
|
88
|
+
/** Failure or refusal detail. */
|
|
89
|
+
message?: string;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** Stable seek position for descending journal pages. */
|
|
93
|
+
export interface IDnsMutationJournalCursor {
|
|
94
|
+
createdAt: number;
|
|
95
|
+
id: string;
|
|
96
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A hostname no dcrouter automation may change.
|
|
3
|
+
*
|
|
4
|
+
* Every dcrouter automation that writes DNS records (route DNS, the gateway-client hostname
|
|
5
|
+
* manager, the mail DNS reconciler, migration to a DNS provider) is refused every create, update, delete, adoption and owner
|
|
6
|
+
* handoff of any record type at this exact name; it may only release its ownership of a record
|
|
7
|
+
* there, which leaves the record in place as an operator record. Operator changes through the
|
|
8
|
+
* ops API are not bound. Provider zone mirroring still records what the provider holds.
|
|
9
|
+
*/
|
|
10
|
+
export interface IDnsProtectedHostname {
|
|
11
|
+
/** Exact hostname: lowercase, no trailing dot, no wildcard. Subdomains are not covered. */
|
|
12
|
+
hostname: string;
|
|
13
|
+
reason: string;
|
|
14
|
+
createdBy: string;
|
|
15
|
+
createdAt: number;
|
|
16
|
+
}
|
|
@@ -47,4 +47,9 @@ export interface IDnsRecord {
|
|
|
47
47
|
managedOwnerId?: string;
|
|
48
48
|
/** Deterministic record identity. Unique only when present. */
|
|
49
49
|
managedRecordKey?: string;
|
|
50
|
+
/**
|
|
51
|
+
* True when the record's name is on the protected-hostname list (see
|
|
52
|
+
* `IDnsProtectedHostname`): no automation may change it. Absent otherwise.
|
|
53
|
+
*/
|
|
54
|
+
protectedHostname?: true;
|
|
50
55
|
}
|
|
@@ -9,6 +9,8 @@ export * from './domain.js';
|
|
|
9
9
|
export * from './dns-authority.js';
|
|
10
10
|
export * from './workhoster.js';
|
|
11
11
|
export * from './dns-record.js';
|
|
12
|
+
export * from './dns-mutation-journal.js';
|
|
13
|
+
export * from './dns-protected-hostname.js';
|
|
12
14
|
export * from './acme-config.js';
|
|
13
15
|
export * from './email-domain.js';
|
|
14
16
|
export * from './email-settings.js';
|
|
@@ -21,8 +21,9 @@ export interface IReq_GetDnsAuthority extends plugins.typedrequestInterfaces.imp
|
|
|
21
21
|
}
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
|
-
* Probe a zone's
|
|
25
|
-
* see the evidence
|
|
24
|
+
* Probe a zone's delegation in its parent zone without changing anything. Lets
|
|
25
|
+
* an operator see the evidence (the parent zone and each parent server's
|
|
26
|
+
* answer) before claiming authority.
|
|
26
27
|
*/
|
|
27
28
|
export interface IReq_ProbeDnsAuthorityZone extends plugins.typedrequestInterfaces.implementsTR<
|
|
28
29
|
plugins.typedrequestInterfaces.ITypedRequest,
|
|
@@ -40,9 +41,10 @@ export interface IReq_ProbeDnsAuthorityZone extends plugins.typedrequestInterfac
|
|
|
40
41
|
}
|
|
41
42
|
|
|
42
43
|
/**
|
|
43
|
-
* Claim authority over a zone. Succeeds only
|
|
44
|
-
*
|
|
45
|
-
*
|
|
44
|
+
* Claim authority over a zone. Succeeds only on a `delegated` probe without a
|
|
45
|
+
* DS: the parent zone's servers agree that the zone is delegated to our
|
|
46
|
+
* nameservers and publish no DS for it. The claim is then persisted and
|
|
47
|
+
* reconciled in-process, with no restart.
|
|
46
48
|
*/
|
|
47
49
|
export interface IReq_VerifyDnsAuthorityZone extends plugins.typedrequestInterfaces.implementsTR<
|
|
48
50
|
plugins.typedrequestInterfaces.ITypedRequest,
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import * as plugins from '../plugins.js';
|
|
2
|
+
import type * as authInterfaces from '../data/auth.js';
|
|
3
|
+
import type {
|
|
4
|
+
IDnsMutationJournalCursor,
|
|
5
|
+
IDnsMutationJournalEntry,
|
|
6
|
+
} from '../data/dns-mutation-journal.js';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Read the DNS mutation journal, newest first. Every filter is optional and they combine.
|
|
10
|
+
*/
|
|
11
|
+
export interface IReq_GetDnsMutationJournal extends plugins.typedrequestInterfaces.implementsTR<
|
|
12
|
+
plugins.typedrequestInterfaces.ITypedRequest,
|
|
13
|
+
IReq_GetDnsMutationJournal
|
|
14
|
+
> {
|
|
15
|
+
method: 'getDnsMutationJournal';
|
|
16
|
+
request: {
|
|
17
|
+
identity?: authInterfaces.IIdentity;
|
|
18
|
+
apiToken?: string;
|
|
19
|
+
/** Exact hostname; compared lowercase without a trailing dot. */
|
|
20
|
+
hostname?: string;
|
|
21
|
+
/** Zone name, e.g. 'example.com'. */
|
|
22
|
+
zoneName?: string;
|
|
23
|
+
/** Entries written at or after this time, Unix epoch milliseconds. */
|
|
24
|
+
since?: number;
|
|
25
|
+
/** Entries written at or before this time, Unix epoch milliseconds. */
|
|
26
|
+
until?: number;
|
|
27
|
+
/** Page size, 1 to 200; 100 when omitted. */
|
|
28
|
+
limit?: number;
|
|
29
|
+
cursor?: IDnsMutationJournalCursor;
|
|
30
|
+
};
|
|
31
|
+
response: {
|
|
32
|
+
entries: IDnsMutationJournalEntry[];
|
|
33
|
+
nextCursor?: IDnsMutationJournalCursor;
|
|
34
|
+
};
|
|
35
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import * as plugins from '../plugins.js';
|
|
2
|
+
import type * as authInterfaces from '../data/auth.js';
|
|
3
|
+
import type { IDnsProtectedHostname } from '../data/dns-protected-hostname.js';
|
|
4
|
+
|
|
5
|
+
// ============================================================================
|
|
6
|
+
// Protected DNS hostnames (admin)
|
|
7
|
+
// ============================================================================
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* List the hostnames no automation may change. Requires an admin identity or an admin API token.
|
|
11
|
+
*/
|
|
12
|
+
export interface IReq_GetDnsProtectedHostnames extends plugins.typedrequestInterfaces.implementsTR<
|
|
13
|
+
plugins.typedrequestInterfaces.ITypedRequest,
|
|
14
|
+
IReq_GetDnsProtectedHostnames
|
|
15
|
+
> {
|
|
16
|
+
method: 'getDnsProtectedHostnames';
|
|
17
|
+
request: {
|
|
18
|
+
identity?: authInterfaces.IIdentity;
|
|
19
|
+
apiToken?: string;
|
|
20
|
+
};
|
|
21
|
+
response: {
|
|
22
|
+
hostnames: IDnsProtectedHostname[];
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Protect one exact hostname. Requires an admin identity or an admin API token. The hostname is
|
|
28
|
+
* stored lowercase without a trailing dot; a wildcard is refused. Adding a hostname that is
|
|
29
|
+
* already protected changes nothing and answers success.
|
|
30
|
+
*/
|
|
31
|
+
export interface IReq_AddDnsProtectedHostname extends plugins.typedrequestInterfaces.implementsTR<
|
|
32
|
+
plugins.typedrequestInterfaces.ITypedRequest,
|
|
33
|
+
IReq_AddDnsProtectedHostname
|
|
34
|
+
> {
|
|
35
|
+
method: 'addDnsProtectedHostname';
|
|
36
|
+
request: {
|
|
37
|
+
identity?: authInterfaces.IIdentity;
|
|
38
|
+
apiToken?: string;
|
|
39
|
+
hostname: string;
|
|
40
|
+
reason: string;
|
|
41
|
+
};
|
|
42
|
+
response: {
|
|
43
|
+
success: boolean;
|
|
44
|
+
hostname?: IDnsProtectedHostname;
|
|
45
|
+
message?: string;
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Remove one hostname from the protected list. Requires an admin identity or an admin API token.
|
|
51
|
+
*/
|
|
52
|
+
export interface IReq_RemoveDnsProtectedHostname extends plugins.typedrequestInterfaces.implementsTR<
|
|
53
|
+
plugins.typedrequestInterfaces.ITypedRequest,
|
|
54
|
+
IReq_RemoveDnsProtectedHostname
|
|
55
|
+
> {
|
|
56
|
+
method: 'removeDnsProtectedHostname';
|
|
57
|
+
request: {
|
|
58
|
+
identity?: authInterfaces.IIdentity;
|
|
59
|
+
apiToken?: string;
|
|
60
|
+
hostname: string;
|
|
61
|
+
};
|
|
62
|
+
response: {
|
|
63
|
+
success: boolean;
|
|
64
|
+
message?: string;
|
|
65
|
+
};
|
|
66
|
+
}
|
|
@@ -152,6 +152,12 @@ export interface IReq_SyncDomain extends plugins.typedrequestInterfaces.implemen
|
|
|
152
152
|
/**
|
|
153
153
|
* Migrate a domain between dcrouter-hosted and provider-managed (or between providers).
|
|
154
154
|
* Records are transferred to the target and the domain source/providerId are updated.
|
|
155
|
+
*
|
|
156
|
+
* A migration to a provider reads the target zone first and refuses, with
|
|
157
|
+
* nothing written, when a record there conflicts with a migrated record;
|
|
158
|
+
* identical target records are adopted. A failed create rolls back exactly the
|
|
159
|
+
* records the run created. Records at the target that the migration did not
|
|
160
|
+
* create are never changed or deleted.
|
|
155
161
|
*/
|
|
156
162
|
export interface IReq_MigrateDomain extends plugins.typedrequestInterfaces.implementsTR<
|
|
157
163
|
plugins.typedrequestInterfaces.ITypedRequest,
|
|
@@ -166,7 +172,10 @@ export interface IReq_MigrateDomain extends plugins.typedrequestInterfaces.imple
|
|
|
166
172
|
targetSource: import('../data/domain.js').TDomainSource;
|
|
167
173
|
/** Required when targetSource is 'provider'. */
|
|
168
174
|
targetProviderId?: string;
|
|
169
|
-
/**
|
|
175
|
+
/**
|
|
176
|
+
* @deprecated Refused when `true`: a migration never deletes records at the
|
|
177
|
+
* provider that it did not create. Omit it or send `false`.
|
|
178
|
+
*/
|
|
170
179
|
deleteExistingProviderRecords?: boolean;
|
|
171
180
|
};
|
|
172
181
|
response: {
|
|
@@ -18,6 +18,8 @@ export * from './dns-providers.js';
|
|
|
18
18
|
export * from './domains.js';
|
|
19
19
|
export * from './dns-authority.js';
|
|
20
20
|
export * from './dns-records.js';
|
|
21
|
+
export * from './dns-protected-hostnames.js';
|
|
22
|
+
export * from './dns-mutation-journal.js';
|
|
21
23
|
export * from './acme-config.js';
|
|
22
24
|
export * from './email-domains.js';
|
|
23
25
|
export * from './email-settings.js';
|