@authup/server-core 1.0.0-beta.52 → 1.0.0-beta.54

package/dist/core/client-certificate/module.mjs

@@ -0,0 +1,196 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import "./reflect.mjs";
+import { base64URLEncode } from "@authup/kit";
+import { CLIENT_CERTIFICATE_URI_PREFIX, buildClientCertificateURI } from "@authup/core-kit";
+import { ValidationError } from "@authup/errors";
+import { AuthorityKeyIdentifierExtension, BasicConstraintsExtension, ExtendedKeyUsage, ExtendedKeyUsageExtension, KeyUsageFlags, KeyUsagesExtension, SubjectAlternativeNameExtension, SubjectKeyIdentifierExtension, URL, X509Certificate } from "@peculiar/x509";
+//#region src/core/client-certificate/module.ts
+const MAX_CHAIN_DEPTH = 10;
+const CERTIFICATE_BLOCK_PATTERN = /-----BEGIN CERTIFICATE-----[\s\S]*?-----END CERTIFICATE-----/g;
+/**
+* Hard ceiling on signature verifications performed while building a single
+* certification path. A legitimate chain of the maximum accepted length only
+* needs O(depth²) verifications; the ceiling exists purely to defuse the
+* factorial backtracking blow-up an attacker can induce with certificates
+* that mutually "issue" one another (shared key, identical subject/issuer
+* DNs). Reaching the ceiling is treated as "no path found" (fail closed).
+*/ const MAX_PATH_SIGNATURE_VERIFICATIONS = 64;
+/**
+* OIDs of the certificate extensions this validator actually processes. A
+* certificate carrying a *critical* extension outside this set is rejected
+* (RFC 5280 §4.2): an unprocessed critical constraint must never be silently
+* ignored. Because RFC 5280 requires the NameConstraints extension to be
+* marked critical, this also fails a name-constrained CA closed rather than
+* trusting a chain whose name constraints we do not evaluate.
+*/ const HANDLED_CRITICAL_EXTENSION_OIDS = /* @__PURE__ */ new Set([
+	"2.5.29.19",
+	"2.5.29.15",
+	"2.5.29.37",
+	"2.5.29.17",
+	"2.5.29.35",
+	"2.5.29.14"
+]);
+const WEAK_SIGNATURE_HASHES = /* @__PURE__ */ new Set([
+	"SHA-1",
+	"MD5",
+	"MD2",
+	"MD4"
+]);
+const ANY_EXTENDED_KEY_USAGE_OID = "2.5.29.37.0";
+/**
+* Validates client certificates without performing network I/O. AIA, CRL,
+* and OCSP retrieval are deliberately outside the external-PKI first slice.
+*/ var ClientCertificateValidator = class {
+	trustAnchorRepository;
+	crypto;
+	constructor(ctx) {
+		this.trustAnchorRepository = ctx.trustAnchorRepository;
+		this.crypto = ctx.crypto;
+	}
+	validateForBinding(evidence) {
+		assertClientCertificateEvidenceValidForBinding(evidence);
+	}
+	async validateForAuthentication(client, evidence) {
+		this.validateForBinding(evidence);
+		assertClientCertificatePurpose(evidence.certificate);
+		assertClientCertificateIdentity(evidence.certificate, client.id);
+		assertCertificateExtensionsUnderstood(evidence.certificate);
+		assertStrongSignature(evidence.certificate);
+		const anchors = await this.trustAnchorRepository.findManyBy({
+			realmId: client.realmId,
+			enabled: true
+		});
+		for (const anchor of anchors) {
+			const anchorCertificate = parseAnchorCertificate(anchor);
+			if (!anchorCertificate) continue;
+			const budget = { remaining: MAX_PATH_SIGNATURE_VERIFICATIONS };
+			const path = await buildPath(evidence.certificate, evidence.chain, anchorCertificate, budget, this.crypto);
+			if (!path) continue;
+			try {
+				assertCertificationPath(path);
+				return;
+			} catch {
+				continue;
+			}
+		}
+		throw new ValidationError("The client certificate is not trusted in this realm.");
+	}
+};
+function assertClientCertificateEvidenceValidForBinding(evidence) {
+	assertCertificateCurrent(evidence.certificate);
+	if (evidence.certificate.getExtension(BasicConstraintsExtension)?.ca) throw new ValidationError("A CA certificate cannot be used as a client certificate.");
+}
+function parseClientCertificateChain(pem) {
+	const blocks = pem.match(CERTIFICATE_BLOCK_PATTERN);
+	if (!blocks || blocks.length === 0) throw new ValidationError("The certificate chain could not be parsed.");
+	try {
+		return blocks.map((block) => new X509Certificate(block));
+	} catch {
+		throw new ValidationError("The certificate chain could not be parsed.");
+	}
+}
+async function buildClientCertificateThumbprint(certificate, crypto) {
+	const digest = await certificate.getThumbprint("SHA-256", crypto);
+	return base64URLEncode(String.fromCharCode(...new Uint8Array(digest)));
+}
+function parseAnchorCertificate(anchor) {
+	try {
+		return parseClientCertificateChain(anchor.certificate)[0];
+	} catch {
+		return;
+	}
+}
+async function buildPath(leaf, intermediates, anchor, budget, crypto) {
+	return continuePath(leaf, intermediates, anchor, [leaf], budget, crypto);
+}
+async function continuePath(current, available, anchor, path, budget, crypto) {
+	if (path.length > MAX_CHAIN_DEPTH) return;
+	if (sameCertificate(current, anchor)) return path;
+	if (await isIssuedBy(current, anchor, budget, crypto)) return [...path, anchor];
+	for (let index = 0; index < available.length; index += 1) {
+		const candidate = available[index];
+		if (!candidate || sameCertificate(current, candidate) || !await isIssuedBy(current, candidate, budget, crypto)) continue;
+		const next = await continuePath(candidate, available.filter((_item, candidateIndex) => candidateIndex !== index), anchor, [...path, candidate], budget, crypto);
+		if (next) return next;
+	}
+}
+async function isIssuedBy(certificate, issuer, budget, crypto) {
+	if (certificate.issuer !== issuer.subject) return false;
+	const authorityKeyIdentifier = certificate.getExtension(AuthorityKeyIdentifierExtension);
+	if (authorityKeyIdentifier?.keyId) {
+		const subjectKeyIdentifier = issuer.getExtension(SubjectKeyIdentifierExtension);
+		if (subjectKeyIdentifier && subjectKeyIdentifier.keyId !== authorityKeyIdentifier.keyId) return false;
+	}
+	if (budget.remaining <= 0) return false;
+	budget.remaining -= 1;
+	try {
+		return await certificate.verify({
+			publicKey: issuer,
+			signatureOnly: true
+		}, crypto);
+	} catch {
+		return false;
+	}
+}
+function sameCertificate(left, right) {
+	const leftRaw = new Uint8Array(left.rawData);
+	const rightRaw = new Uint8Array(right.rawData);
+	return leftRaw.length === rightRaw.length && leftRaw.every((value, index) => value === rightRaw[index]);
+}
+function assertCertificationPath(path) {
+	if (path.length < 2) throw new ValidationError("The client certificate chain is invalid.");
+	for (let index = 1; index < path.length; index += 1) {
+		const certificate = path[index];
+		if (!certificate) throw new ValidationError("The client certificate chain is invalid.");
+		if (!(index === path.length - 1)) {
+			assertCertificateExtensionsUnderstood(certificate);
+			assertStrongSignature(certificate);
+			assertIssuerExtendedKeyUsage(certificate);
+		}
+		assertCertificateCurrent(certificate);
+		const constraints = certificate.getExtension(BasicConstraintsExtension);
+		if (!constraints?.ca) throw new ValidationError("The client certificate chain contains a non-CA issuer.");
+		const keyUsage = certificate.getExtension(KeyUsagesExtension);
+		if (keyUsage && (keyUsage.usages & KeyUsageFlags.keyCertSign) === 0) throw new ValidationError("A client certificate issuer cannot sign certificates.");
+		if (typeof constraints.pathLength === "number" && index - 1 > constraints.pathLength) throw new ValidationError("The client certificate chain exceeds a CA path-length constraint.");
+	}
+}
+function assertClientCertificatePurpose(certificate) {
+	const extendedKeyUsage = certificate.getExtension(ExtendedKeyUsageExtension);
+	if (extendedKeyUsage && !extendedKeyUsage.usages.includes(ExtendedKeyUsage.clientAuth)) throw new ValidationError("The certificate is not valid for TLS client authentication.");
+	const keyUsage = certificate.getExtension(KeyUsagesExtension);
+	if (keyUsage && (keyUsage.usages & KeyUsageFlags.digitalSignature) === 0) throw new ValidationError("The certificate cannot prove possession of its private key.");
+}
+/**
+* EKU chaining (RFC 5280 §4.2.1.12): a CA whose Extended Key Usage is present
+* but omits both `clientAuth` and `anyExtendedKeyUsage` is not permitted to
+* issue TLS-client-authentication certificates, so a leaf beneath it must be
+* rejected. (A CA's EKU may be non-critical, so the critical-extension check
+* does not cover this.) A CA with no EKU extension is unconstrained.
+*/ function assertIssuerExtendedKeyUsage(certificate) {
+	const extendedKeyUsage = certificate.getExtension(ExtendedKeyUsageExtension);
+	if (extendedKeyUsage && !extendedKeyUsage.usages.includes(ExtendedKeyUsage.clientAuth) && !extendedKeyUsage.usages.includes(ANY_EXTENDED_KEY_USAGE_OID)) throw new ValidationError("A client certificate issuer is not permitted to issue TLS client-authentication certificates.");
+}
+function assertClientCertificateIdentity(certificate, clientId) {
+	const subjectAlternativeName = certificate.getExtension(SubjectAlternativeNameExtension);
+	const authupUris = subjectAlternativeName ? subjectAlternativeName.names.items.filter((name) => name.type === URL).map((name) => name.value).filter((value) => value.startsWith(CLIENT_CERTIFICATE_URI_PREFIX)) : [];
+	const expected = buildClientCertificateURI(clientId);
+	if (authupUris.length !== 1 || authupUris[0] !== expected) throw new ValidationError(`The certificate must contain exactly one Authup client URI SAN: ${expected}.`);
+}
+function assertCertificateCurrent(certificate) {
+	const now = Date.now();
+	if (certificate.notBefore.getTime() > now || certificate.notAfter.getTime() < now) throw new ValidationError("The client certificate is not currently valid.");
+}
+function assertCertificateExtensionsUnderstood(certificate) {
+	for (const extension of certificate.extensions) if (extension.critical && !HANDLED_CRITICAL_EXTENSION_OIDS.has(extension.type)) throw new ValidationError(`The certificate carries an unsupported critical extension (${extension.type}).`);
+}
+function assertStrongSignature(certificate) {
+	const hash = certificate.signatureAlgorithm?.hash?.name;
+	if (typeof hash === "string" && WEAK_SIGNATURE_HASHES.has(hash.toUpperCase())) throw new ValidationError(`The certificate is signed with a weak algorithm (${hash}).`);
+}
+//#endregion
+export { ClientCertificateValidator, assertClientCertificateEvidenceValidForBinding, buildClientCertificateThumbprint, parseClientCertificateChain };
+
+//# sourceMappingURL=module.mjs.map

package/dist/core/client-certificate/module.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.mjs","names":["AuthorityKeyIdentifierExtension","BasicConstraintsExtension","ExtendedKeyUsage","ExtendedKeyUsageExtension","URL","GENERAL_NAME_URL","KeyUsageFlags","KeyUsagesExtension","SubjectAlternativeNameExtension","SubjectKeyIdentifierExtension","X509Certificate","CLIENT_CERTIFICATE_URI_PREFIX","buildClientCertificateURI","ValidationError","base64URLEncode","MAX_CHAIN_DEPTH","CERTIFICATE_BLOCK_PATTERN","MAX_PATH_SIGNATURE_VERIFICATIONS","HANDLED_CRITICAL_EXTENSION_OIDS","Set","WEAK_SIGNATURE_HASHES","ANY_EXTENDED_KEY_USAGE_OID","ClientCertificateValidator","trustAnchorRepository","crypto","ctx","validateForBinding","evidence","assertClientCertificateEvidenceValidForBinding","validateForAuthentication","client","assertClientCertificatePurpose","certificate","assertClientCertificateIdentity","id","assertCertificateExtensionsUnderstood","assertStrongSignature","anchors","findManyBy","realmId","enabled","anchor","anchorCertificate","parseAnchorCertificate","budget","remaining","path","buildPath","chain","assertCertificationPath","assertCertificateCurrent","constraints","getExtension","ca","parseClientCertificateChain","pem","blocks","match","length","map","block","buildClientCertificateThumbprint","digest","getThumbprint","String","fromCharCode","Uint8Array","undefined","leaf","intermediates","continuePath","current","available","sameCertificate","isIssuedBy","index","candidate","next","filter","_item","candidateIndex","issuer","subject","authorityKeyIdentifier","keyId","subjectKeyIdentifier","verify","publicKey","signatureOnly","left","right","leftRaw","rawData","rightRaw","every","value","isAnchor","assertIssuerExtendedKeyUsage","keyUsage","usages","keyCertSign","pathLength","extendedKeyUsage","includes","clientAuth","digitalSignature","clientId","subjectAlternativeName","authupUris","names","items","name","type","startsWith","expected","now","Date","notBefore","getTime","notAfter","extension","extensions","critical","has","hash","signatureAlgorithm","toUpperCase"],"sources":["../../../src/core/client-certificate/module.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport './reflect.ts';\nimport {\n    AuthorityKeyIdentifierExtension,\n    BasicConstraintsExtension,\n    ExtendedKeyUsage,\n    ExtendedKeyUsageExtension,\n    URL as GENERAL_NAME_URL,\n    KeyUsageFlags,\n    KeyUsagesExtension,\n    SubjectAlternativeNameExtension,\n    SubjectKeyIdentifierExtension,\n    X509Certificate,\n} from '@peculiar/x509';\nimport type { Client, TrustAnchor } from '@authup/core-kit';\nimport {\n    CLIENT_CERTIFICATE_URI_PREFIX,\n    buildClientCertificateURI,\n} from '@authup/core-kit';\nimport { ValidationError } from '@authup/errors';\nimport { base64URLEncode } from '@authup/kit';\nimport type {\n    ClientCertificateEvidence,\n    ClientCertificateValidatorContext,\n    IClientCertificateValidator,\n} from './types.ts';\n\nconst MAX_CHAIN_DEPTH = 10;\nconst CERTIFICATE_BLOCK_PATTERN = /-----BEGIN CERTIFICATE-----[\\s\\S]*?-----END CERTIFICATE-----/g;\n\n/**\n * Hard ceiling on signature verifications performed while building a single\n * certification path. A legitimate chain of the maximum accepted length only\n * needs O(depth²) verifications; the ceiling exists purely to defuse the\n * factorial backtracking blow-up an attacker can induce with certificates\n * that mutually \"issue\" one another (shared key, identical subject/issuer\n * DNs). Reaching the ceiling is treated as \"no path found\" (fail closed).\n */\nconst MAX_PATH_SIGNATURE_VERIFICATIONS = 64;\n\n/**\n * OIDs of the certificate extensions this validator actually processes. A\n * certificate carrying a *critical* extension outside this set is rejected\n * (RFC 5280 §4.2): an unprocessed critical constraint must never be silently\n * ignored. Because RFC 5280 requires the NameConstraints extension to be\n * marked critical, this also fails a name-constrained CA closed rather than\n * trusting a chain whose name constraints we do not evaluate.\n */\nconst HANDLED_CRITICAL_EXTENSION_OIDS = new Set<string>([\n    '2.5.29.19', // basicConstraints\n    '2.5.29.15', // keyUsage\n    '2.5.29.37', // extKeyUsage\n    '2.5.29.17', // subjectAltName\n    '2.5.29.35', // authorityKeyIdentifier\n    '2.5.29.14', // subjectKeyIdentifier\n]);\n\nconst WEAK_SIGNATURE_HASHES = new Set<string>(['SHA-1', 'MD5', 'MD2', 'MD4']);\n\n// anyExtendedKeyUsage (RFC 5280 §4.2.1.12) — a CA carrying it is unconstrained.\nconst ANY_EXTENDED_KEY_USAGE_OID = '2.5.29.37.0';\n\ntype SignatureVerificationBudget = { remaining: number };\n\n/**\n * Validates client certificates without performing network I/O. AIA, CRL,\n * and OCSP retrieval are deliberately outside the external-PKI first slice.\n */\nexport class ClientCertificateValidator implements IClientCertificateValidator {\n    protected trustAnchorRepository: ClientCertificateValidatorContext['trustAnchorRepository'];\n\n    protected crypto?: Crypto;\n\n    constructor(ctx: ClientCertificateValidatorContext) {\n        this.trustAnchorRepository = ctx.trustAnchorRepository;\n        this.crypto = ctx.crypto;\n    }\n\n    validateForBinding(evidence: ClientCertificateEvidence): void {\n        assertClientCertificateEvidenceValidForBinding(evidence);\n    }\n\n    async validateForAuthentication(\n        client: Pick<Client, 'id' | 'realmId'>,\n        evidence: ClientCertificateEvidence,\n    ): Promise<void> {\n        this.validateForBinding(evidence);\n        assertClientCertificatePurpose(evidence.certificate);\n        assertClientCertificateIdentity(evidence.certificate, client.id);\n        assertCertificateExtensionsUnderstood(evidence.certificate);\n        assertStrongSignature(evidence.certificate);\n\n        const anchors = await this.trustAnchorRepository.findManyBy({\n            realmId: client.realmId,\n            enabled: true,\n        });\n\n        for (const anchor of anchors) {\n            const anchorCertificate = parseAnchorCertificate(anchor);\n            if (!anchorCertificate) {\n                continue;\n            }\n\n            const budget: SignatureVerificationBudget = { remaining: MAX_PATH_SIGNATURE_VERIFICATIONS };\n            const path = await buildPath(\n                evidence.certificate,\n                evidence.chain,\n                anchorCertificate,\n                budget,\n                this.crypto,\n            );\n            if (!path) {\n                continue;\n            }\n\n            try {\n                assertCertificationPath(path);\n                return;\n            } catch {\n                // A chain reaching this anchor failed its CA constraints;\n                // another enabled anchor may still yield a valid path.\n                continue;\n            }\n        }\n\n        throw new ValidationError('The client certificate is not trusted in this realm.');\n    }\n}\n\nexport function assertClientCertificateEvidenceValidForBinding(\n    evidence: ClientCertificateEvidence,\n): void {\n    assertCertificateCurrent(evidence.certificate);\n\n    const constraints = evidence.certificate.getExtension(BasicConstraintsExtension);\n    if (constraints?.ca) {\n        throw new ValidationError('A CA certificate cannot be used as a client certificate.');\n    }\n}\n\nexport function parseClientCertificateChain(pem: string): X509Certificate[] {\n    const blocks = pem.match(CERTIFICATE_BLOCK_PATTERN);\n    if (!blocks || blocks.length === 0) {\n        throw new ValidationError('The certificate chain could not be parsed.');\n    }\n\n    try {\n        return blocks.map((block) => new X509Certificate(block));\n    } catch {\n        throw new ValidationError('The certificate chain could not be parsed.');\n    }\n}\n\nexport async function buildClientCertificateThumbprint(\n    certificate: X509Certificate,\n    crypto?: Crypto,\n): Promise<string> {\n    const digest = await certificate.getThumbprint('SHA-256', crypto);\n\n    return base64URLEncode(\n        String.fromCharCode(...new Uint8Array(digest)),\n    );\n}\n\nfunction parseAnchorCertificate(anchor: TrustAnchor): X509Certificate | undefined {\n    try {\n        return parseClientCertificateChain(anchor.certificate)[0];\n    } catch {\n        // Rows are validated on create. Treat a corrupt legacy/database row as\n        // unusable trust material instead of turning client authentication into\n        // a 500 or accidentally trusting another certificate in its PEM chain.\n        return undefined;\n    }\n}\n\nasync function buildPath(\n    leaf: X509Certificate,\n    intermediates: X509Certificate[],\n    anchor: X509Certificate,\n    budget: SignatureVerificationBudget,\n    crypto?: Crypto,\n): Promise<X509Certificate[] | undefined> {\n    return continuePath(leaf, intermediates, anchor, [leaf], budget, crypto);\n}\n\nasync function continuePath(\n    current: X509Certificate,\n    available: X509Certificate[],\n    anchor: X509Certificate,\n    path: X509Certificate[],\n    budget: SignatureVerificationBudget,\n    crypto?: Crypto,\n): Promise<X509Certificate[] | undefined> {\n    if (path.length > MAX_CHAIN_DEPTH) {\n        return undefined;\n    }\n\n    if (sameCertificate(current, anchor)) {\n        return path;\n    }\n\n    if (await isIssuedBy(current, anchor, budget, crypto)) {\n        return [...path, anchor];\n    }\n\n    for (let index = 0; index < available.length; index += 1) {\n        const candidate = available[index];\n        if (\n            !candidate ||\n            sameCertificate(current, candidate) ||\n            !await isIssuedBy(current, candidate, budget, crypto)\n        ) {\n            continue;\n        }\n\n        const next = await continuePath(\n            candidate,\n            available.filter((_item, candidateIndex) => candidateIndex !== index),\n            anchor,\n            [...path, candidate],\n            budget,\n            crypto,\n        );\n        if (next) {\n            return next;\n        }\n    }\n\n    return undefined;\n}\n\nasync function isIssuedBy(\n    certificate: X509Certificate,\n    issuer: X509Certificate,\n    budget: SignatureVerificationBudget,\n    crypto?: Crypto,\n): Promise<boolean> {\n    if (certificate.issuer !== issuer.subject) {\n        return false;\n    }\n\n    const authorityKeyIdentifier = certificate.getExtension(AuthorityKeyIdentifierExtension);\n    if (authorityKeyIdentifier?.keyId) {\n        const subjectKeyIdentifier = issuer.getExtension(SubjectKeyIdentifierExtension);\n        if (subjectKeyIdentifier && subjectKeyIdentifier.keyId !== authorityKeyIdentifier.keyId) {\n            return false;\n        }\n    }\n\n    // Spend from the shared verification budget only for the expensive\n    // cryptographic check (the DN / key-id pre-filters above are cheap). Once\n    // exhausted, treat every further edge as unverified so a maliciously\n    // crafted mutually-issuing certificate set cannot force factorial work.\n    if (budget.remaining <= 0) {\n        return false;\n    }\n    budget.remaining -= 1;\n\n    try {\n        return await certificate.verify({\n            publicKey: issuer,\n            signatureOnly: true,\n        }, crypto);\n    } catch {\n        return false;\n    }\n}\n\nfunction sameCertificate(left: X509Certificate, right: X509Certificate): boolean {\n    const leftRaw = new Uint8Array(left.rawData);\n    const rightRaw = new Uint8Array(right.rawData);\n\n    return leftRaw.length === rightRaw.length &&\n        leftRaw.every((value, index) => value === rightRaw[index]);\n}\n\nfunction assertCertificationPath(path: X509Certificate[]): void {\n    if (path.length < 2) {\n        throw new ValidationError('The client certificate chain is invalid.');\n    }\n\n    for (let index = 1; index < path.length; index += 1) {\n        const certificate = path[index];\n        if (!certificate) {\n            throw new ValidationError('The client certificate chain is invalid.');\n        }\n\n        // The last path element is the configured trust anchor, trusted a\n        // priori — its self-signature algorithm and any critical extensions\n        // it carries are the operator's responsibility, so the RFC 5280\n        // conformance checks below apply only to the issued intermediates.\n        const isAnchor = index === path.length - 1;\n        if (!isAnchor) {\n            assertCertificateExtensionsUnderstood(certificate);\n            assertStrongSignature(certificate);\n            assertIssuerExtendedKeyUsage(certificate);\n        }\n\n        assertCertificateCurrent(certificate);\n        const constraints = certificate.getExtension(BasicConstraintsExtension);\n        if (!constraints?.ca) {\n            throw new ValidationError('The client certificate chain contains a non-CA issuer.');\n        }\n\n        const keyUsage = certificate.getExtension(KeyUsagesExtension);\n        if (keyUsage && (keyUsage.usages & KeyUsageFlags.keyCertSign) === 0) {\n            throw new ValidationError('A client certificate issuer cannot sign certificates.');\n        }\n\n        // `index - 1` is the number of non-leaf CA certificates below this\n        // issuer in the selected path. A pathLenConstraint of zero therefore\n        // permits a directly-issued client leaf and no subordinate CA.\n        if (\n            typeof constraints.pathLength === 'number' &&\n            (index - 1) > constraints.pathLength\n        ) {\n            throw new ValidationError('The client certificate chain exceeds a CA path-length constraint.');\n        }\n    }\n}\n\nfunction assertClientCertificatePurpose(certificate: X509Certificate): void {\n    const extendedKeyUsage = certificate.getExtension(ExtendedKeyUsageExtension);\n    if (\n        extendedKeyUsage &&\n        !extendedKeyUsage.usages.includes(ExtendedKeyUsage.clientAuth)\n    ) {\n        throw new ValidationError('The certificate is not valid for TLS client authentication.');\n    }\n\n    const keyUsage = certificate.getExtension(KeyUsagesExtension);\n    if (keyUsage && (keyUsage.usages & KeyUsageFlags.digitalSignature) === 0) {\n        throw new ValidationError('The certificate cannot prove possession of its private key.');\n    }\n}\n\n/**\n * EKU chaining (RFC 5280 §4.2.1.12): a CA whose Extended Key Usage is present\n * but omits both `clientAuth` and `anyExtendedKeyUsage` is not permitted to\n * issue TLS-client-authentication certificates, so a leaf beneath it must be\n * rejected. (A CA's EKU may be non-critical, so the critical-extension check\n * does not cover this.) A CA with no EKU extension is unconstrained.\n */\nfunction assertIssuerExtendedKeyUsage(certificate: X509Certificate): void {\n    const extendedKeyUsage = certificate.getExtension(ExtendedKeyUsageExtension);\n    if (\n        extendedKeyUsage &&\n        !extendedKeyUsage.usages.includes(ExtendedKeyUsage.clientAuth) &&\n        !extendedKeyUsage.usages.includes(ANY_EXTENDED_KEY_USAGE_OID)\n    ) {\n        throw new ValidationError('A client certificate issuer is not permitted to issue TLS client-authentication certificates.');\n    }\n}\n\nfunction assertClientCertificateIdentity(certificate: X509Certificate, clientId: string): void {\n    const subjectAlternativeName = certificate.getExtension(SubjectAlternativeNameExtension);\n    const authupUris = subjectAlternativeName ?\n        subjectAlternativeName.names.items\n            .filter((name) => name.type === GENERAL_NAME_URL)\n            .map((name) => name.value)\n            .filter((value) => value.startsWith(CLIENT_CERTIFICATE_URI_PREFIX)) :\n        [];\n\n    const expected = buildClientCertificateURI(clientId);\n    if (authupUris.length !== 1 || authupUris[0] !== expected) {\n        throw new ValidationError(`The certificate must contain exactly one Authup client URI SAN: ${expected}.`);\n    }\n}\n\nfunction assertCertificateCurrent(certificate: X509Certificate): void {\n    const now = Date.now();\n    if (\n        certificate.notBefore.getTime() > now ||\n        certificate.notAfter.getTime() < now\n    ) {\n        throw new ValidationError('The client certificate is not currently valid.');\n    }\n}\n\nfunction assertCertificateExtensionsUnderstood(certificate: X509Certificate): void {\n    for (const extension of certificate.extensions) {\n        if (extension.critical && !HANDLED_CRITICAL_EXTENSION_OIDS.has(extension.type)) {\n            throw new ValidationError(\n                `The certificate carries an unsupported critical extension (${extension.type}).`,\n            );\n        }\n    }\n}\n\nfunction assertStrongSignature(certificate: X509Certificate): void {\n    const hash = certificate.signatureAlgorithm?.hash?.name;\n    if (typeof hash === 'string' && WEAK_SIGNATURE_HASHES.has(hash.toUpperCase())) {\n        throw new ValidationError(`The certificate is signed with a weak algorithm (${hash}).`);\n    }\n}\n"],"mappings":"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"}

package/dist/core/client-certificate/reflect.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=reflect.d.ts.map

package/dist/core/client-certificate/reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../../../src/core/client-certificate/reflect.ts"],"names":[],"mappings":"AAeA,OAAO,kBAAkB,CAAC"}

package/dist/core/client-certificate/reflect.mjs

@@ -0,0 +1,5 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import "reflect-metadata";
+export {};

package/dist/core/client-certificate/types.d.ts

@@ -0,0 +1,22 @@
+import type { X509Certificate } from '@peculiar/x509';
+import type { Client } from '@authup/core-kit';
+import type { ITrustAnchorRepository } from '../entities/index.ts';
+/**
+ * Runtime-neutral evidence derived from the certificate used in the external
+ * client-facing TLS handshake. `chain` excludes the leaf and is ordered as it
+ * appeared on the wire when the forwarding format preserves that order.
+ */
+export type ClientCertificateEvidence = {
+    certificate: X509Certificate;
+    chain: X509Certificate[];
+    thumbprint: string;
+};
+export type ClientCertificateValidatorContext = {
+    trustAnchorRepository: Pick<ITrustAnchorRepository, 'findManyBy'>;
+    crypto?: Crypto;
+};
+export interface IClientCertificateValidator {
+    validateForBinding(evidence: ClientCertificateEvidence): void;
+    validateForAuthentication(client: Pick<Client, 'id' | 'realmId'>, evidence: ClientCertificateEvidence): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/client-certificate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/client-certificate/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,WAAW,EAAE,eAAe,CAAC;IAC7B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC5C,qBAAqB,EAAE,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,2BAA2B;IACxC,kBAAkB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC9D,yBAAyB,CACrB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC,EACtC,QAAQ,EAAE,yBAAyB,GACpC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB"}

package/dist/core/entities/client/index.d.ts

@@ -1,4 +1,5 @@
 export * from './service.ts';
 export * from './types.ts';
 export * from './web-client.ts';
+export * from './schema.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/entities/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/client/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/client/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/core/entities/client/index.mjs

@@ -1,6 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { clientSchema } from "./schema.mjs";
 import { ClientService } from "./service.mjs";
 import { WebClientProvisioner, buildWebClientAttributes } from "./web-client.mjs";
-export { ClientService, WebClientProvisioner, buildWebClientAttributes };
+export { ClientService, WebClientProvisioner, buildWebClientAttributes, clientSchema };

package/dist/core/entities/client/schema.d.ts

@@ -0,0 +1,3 @@
+import type { Client } from '@authup/core-kit';
+export declare const clientSchema: import("@rapiq/core").Schema<Client, any>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/entities/client/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/client/schema.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM/C,eAAO,MAAM,YAAY,2CAgCvB,CAAC"}

package/dist/core/entities/client/schema.mjs

@@ -0,0 +1,59 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { createRelationsReadGate } from "../../query/relations.mjs";
+import { EntityType } from "@authup/core-kit";
+import { defineSchema } from "@rapiq/core";
+//#region src/core/entities/client/schema.ts
+const schemaMapping = {
+	realm: EntityType.REALM,
+	accessPolicy: EntityType.POLICY
+};
+const clientSchema = defineSchema({
+	name: EntityType.CLIENT,
+	fields: {
+		default: [
+			"id",
+			"active",
+			"builtIn",
+			"name",
+			"displayName",
+			"description",
+			"secretHashed",
+			"secretEncrypted",
+			"baseUrl",
+			"rootUrl",
+			"redirectUri",
+			"postLogoutRedirectUri",
+			"grantTypes",
+			"scope",
+			"authMethod",
+			"tokenBindingMethod",
+			"accessPolicyId",
+			"realmId",
+			"updatedAt",
+			"createdAt"
+		],
+		allowed: ["secret"]
+	},
+	filters: { allowed: [
+		"id",
+		"name",
+		"realmId"
+	] },
+	relations: {
+		allowed: ["realm", "accessPolicy"],
+		validate: createRelationsReadGate(schemaMapping)
+	},
+	sort: { allowed: [
+		"id",
+		"createdAt",
+		"updatedAt"
+	] },
+	pagination: { maxLimit: 50 },
+	schemaMapping
+});
+//#endregion
+export { clientSchema };
+
+//# sourceMappingURL=schema.mjs.map

package/dist/core/entities/client/schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.mjs","names":["defineSchema","EntityType","createRelationsReadGate","schemaMapping","realm","REALM","accessPolicy","POLICY","clientSchema","name","CLIENT","fields","default","allowed","filters","relations","validate","sort","pagination","maxLimit"],"sources":["../../../../src/core/entities/client/schema.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { defineSchema } from '@rapiq/core';\nimport type { Client } from '@authup/core-kit';\nimport { EntityType } from '@authup/core-kit';\nimport { createRelationsReadGate } from '../../query/relations.ts';\n\nconst schemaMapping = { realm: EntityType.REALM, accessPolicy: EntityType.POLICY };\n\nexport const clientSchema = defineSchema<Client>({\n    name: EntityType.CLIENT,\n    fields: {\n        default: [\n            'id',\n            'active',\n            'builtIn',\n            'name',\n            'displayName',\n            'description',\n            'secretHashed',\n            'secretEncrypted',\n            'baseUrl',\n            'rootUrl',\n            'redirectUri',\n            'postLogoutRedirectUri',\n            'grantTypes',\n            'scope',\n            'authMethod',\n            'tokenBindingMethod',\n            'accessPolicyId',\n            'realmId',\n            'updatedAt',\n            'createdAt',\n        ],\n        allowed: ['secret'],\n    },\n    filters: { allowed: ['id', 'name', 'realmId'] },\n    relations: { allowed: ['realm', 'accessPolicy'], validate: createRelationsReadGate(schemaMapping) },\n    sort: { allowed: ['id', 'createdAt', 'updatedAt'] },\n    pagination: { maxLimit: 50 },\n    schemaMapping,\n});\n"],"mappings":";;;;;;;AAYA,MAAMG,gBAAgB;CAAEC,OAAOH,WAAWI;CAAOC,cAAcL,WAAWM;AAAO;AAEjF,MAAaC,eAAeR,aAAqB;CAC7CS,MAAMR,WAAWS;CACjBC,QAAQ;EACJC,SAAS;GACL;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;;EAEJC,SAAS,CAAC,QAAA;CACd;CACAC,SAAS,EAAED,SAAS;EAAC;EAAM;EAAQ;GAAW;CAC9CE,WAAW;EAAEF,SAAS,CAAC,SAAS,cAAA;EAAiBG,UAAUd,wBAAwBC,aAAAA;CAAe;CAClGc,MAAM,EAAEJ,SAAS;EAAC;EAAM;EAAa;GAAa;CAClDK,YAAY,EAAEC,UAAU,GAAG;CAC3BhB;AACJ,CAAA"}

package/dist/core/entities/client/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/client/service.ts"],"names":[],"mappings":"AAUA,OAAO,EAEH,eAAe,EAElB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAG,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,MAAM,oBAAoB,GAAG;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,eAAe,EAAE,gBAAgB,CAAC;CACrC,CAAC;AAEF,qBAAa,aAAc,SAAQ,qBAAsB,YAAW,cAAc;IAC9E,SAAS,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAExC,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE5C,SAAS,CAAC,SAAS,EAAE,eAAe,CAAC;gBAEzB,GAAG,EAAE,oBAAoB;IAO/B,OAAO,CACT,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAmD5C,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IA2CZ,MAAM,CACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;IAKZ,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;IAKZ,IAAI,CACN,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACvC,OAAO,CAAC;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAA;KACnB,CAAC;IAuJI,MAAM,CACR,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;CAmBrB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/client/service.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGH,eAAe,EAElB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B,EAAG,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIpE,MAAM,MAAM,oBAAoB,GAAG;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,eAAe,EAAE,gBAAgB,CAAC;CACrC,CAAC;AAEF,qBAAa,aAAc,SAAQ,qBAAsB,YAAW,cAAc;IAC9E,SAAS,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAExC,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE5C,SAAS,CAAC,SAAS,EAAE,eAAe,CAAC;gBAEzB,GAAG,EAAE,oBAAoB;IAO/B,OAAO,CACT,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAmF5C,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAmDZ,MAAM,CACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;IAKZ,MAAM,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;IAKZ,IAAI,CACN,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACvC,OAAO,CAAC;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAA;KACnB,CAAC;IA2JI,MAAM,CACR,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;CAmBrB"}

package/dist/core/entities/client/service.mjs

@@ -2,11 +2,15 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { ClientCredentialsService } from "../../authentication/credential/entities/client/module.mjs";
+import { clientSchema } from "./schema.mjs";
+import { appendQueryConditions, decodeQuery } from "../../query/module.mjs";
+import "../../query/index.mjs";
 import { ValidatorGroup, isUUID } from "@authup/kit";
-import { CLIENT_RESERVED_NAMES, ClientValidator, PermissionName } from "@authup/core-kit";
+import { CLIENT_RESERVED_NAMES, ClientAuthMethod, ClientValidator, PermissionName } from "@authup/core-kit";
 import { AbstractEntityService } from "@authup/server-kit";
 import { BuiltInPolicyType, definePolicyData } from "@authup/access";
-import { BadRequestError, EntityNotFoundError } from "@authup/errors";
+import { EntityNotFoundError, ValidationError } from "@authup/errors";
+import { and, eq, ne, not, or } from "@rapiq/core";
 //#region src/core/entities/client/service.ts
 var ClientService = class extends AbstractEntityService {
 	repository;
@@ -19,16 +23,31 @@ var ClientService = class extends AbstractEntityService {
 		this.validator = new ClientValidator();
 	}
 	async getMany(query, actor) {
-		await actor.permissionEvaluator.preEvaluateOneOf({ name: [
+		const permissionNames = [
 			PermissionName.CLIENT_READ,
 			PermissionName.CLIENT_UPDATE,
 			PermissionName.CLIENT_DELETE
-		] });
-		const { data: entities, meta } = await this.repository.findMany(query);
+		];
+		await actor.permissionEvaluator.preEvaluateOneOf({ name: permissionNames });
+		const parsed = await decodeQuery(query, {
+			schema: clientSchema,
+			actor
+		});
+		const secretSelected = parsed.fields.value.some((field) => field.name === "secret" && field.operator !== "-");
+		const compiled = await actor.permissionEvaluator.compile({ name: permissionNames });
+		if (compiled.verdict !== "post") {
+			let scoped = parsed;
+			if (secretSelected && compiled.verdict !== "allow") {
+				const plaintextSecret = and(ne("secret", null), eq("secretHashed", false), eq("secretEncrypted", false));
+				scoped = appendQueryConditions(parsed, compiled.verdict === "conditional" ? or(not(plaintextSecret), compiled.condition) : not(plaintextSecret));
+			}
+			return this.repository.findMany(scoped);
+		}
+		const { data: entities, meta } = await this.repository.findMany(parsed);
 		let { total } = meta;
 		const data = [];
 		for (const entity of entities) {
-			if (entity.secret && !entity.secret_encrypted && !entity.secret_hashed) {
+			if (entity.secret && !entity.secretEncrypted && !entity.secretHashed) {
 				try {
 					await actor.permissionEvaluator.evaluateOneOf({
 						name: [
@@ -65,13 +84,17 @@ var ClientService = class extends AbstractEntityService {
 		];
 		let isMe = !!actor.identity && actor.identity.type === "client" && (actor.identity.data.id === idOrName || actor.identity.data.name === idOrName);
 		if (!isMe) await actor.permissionEvaluator.preEvaluateOneOf({ name: permissionNames });
-		const entity = await this.repository.findOne(idOrName, query, realmId);
+		const entity = await this.repository.findOne(idOrName, await decodeQuery(query, {
+			schema: clientSchema,
+			parameters: ["fields", "relations"],
+			actor
+		}), realmId);
 		if (!entity) throw new EntityNotFoundError();
 		if (isMe && actor.identity.data.id !== entity.id) {
 			isMe = false;
 			await actor.permissionEvaluator.preEvaluateOneOf({ name: permissionNames });
 		}
-		if (!isMe && entity.secret && !entity.secret_encrypted && !entity.secret_hashed) await actor.permissionEvaluator.evaluateOneOf({
+		if (!isMe && entity.secret && !entity.secretEncrypted && !entity.secretHashed) await actor.permissionEvaluator.evaluateOneOf({
 			name: permissionNames,
 			data: definePolicyData({
 				[BuiltInPolicyType.ATTRIBUTES]: entity,
@@ -90,13 +113,13 @@ var ClientService = class extends AbstractEntityService {
 	}
 	async save(idOrName, data, actor, options = {}) {
 		let group;
-		const realm = typeof data.realm_id === "string" ? await this.realmRepository.resolve(data.realm_id) : void 0;
+		const realm = typeof data.realmId === "string" ? await this.realmRepository.resolve(data.realmId) : void 0;
 		let entity;
 		if (idOrName) {
 			const where = {};
 			if (isUUID(idOrName)) where.id = idOrName;
 			else where.name = idOrName;
-			if (realm) where.realm_id = realm.id;
+			if (realm) where.realmId = realm.id;
 			entity = await this.repository.findOneWithSecret(where);
 			if (!entity && options.updateOnly) throw new EntityNotFoundError();
 		} else if (options.updateOnly) throw new EntityNotFoundError();
@@ -115,14 +138,14 @@ var ClientService = class extends AbstractEntityService {
 			group = ValidatorGroup.CREATE;
 		}
 		const validated = await this.validator.run(data, { group });
-		if (typeof validated.name === "string" && CLIENT_RESERVED_NAMES.includes(validated.name) && !(entity && entity.built_in && entity.name === validated.name)) throw new BadRequestError(`The client name '${validated.name}' is reserved.`);
+		if (typeof validated.name === "string" && CLIENT_RESERVED_NAMES.includes(validated.name) && !(entity && entity.builtIn && entity.name === validated.name)) throw new ValidationError(`The client name '${validated.name}' is reserved.`);
 		await this.repository.validateJoinColumns(validated);
 		await this.repository.checkUniqueness(validated, entity || void 0);
 		const credentialsService = new ClientCredentialsService();
 		if (entity) {
-			if (!isSelfEdit && !validated.realm_id && !entity.realm_id) {
+			if (!isSelfEdit && !validated.realmId && !entity.realmId) {
 				const actorRealmId = this.getActorRealmId(actor);
-				if (actorRealmId) validated.realm_id = actorRealmId;
+				if (actorRealmId) validated.realmId = actorRealmId;
 			}
 			if (isSelfEdit) await actor.permissionEvaluator.evaluate({
 				name: PermissionName.CLIENT_SELF_MANAGE,
@@ -139,19 +162,23 @@ var ClientService = class extends AbstractEntityService {
 					...this.resourceRealmMatch(entity)
 				})
 			});
-			if (entity.is_confidential) {
+			if (entity.authMethod === ClientAuthMethod.SECRET) {
 				if (!validated.secret && !entity.secret) validated.secret = credentialsService.generateSecret();
 				if (validated.secret) entity.secret = await credentialsService.protect(validated.secret, entity);
-			} else entity.secret = null;
+			} else {
+				entity.secret = null;
+				entity.secretHashed = false;
+				entity.secretEncrypted = false;
+			}
 			await this.repository.save(entity);
 			return {
 				entity,
 				created: false
 			};
 		}
-		if (!validated.realm_id) {
+		if (!validated.realmId) {
 			const actorRealmId = this.getActorRealmId(actor);
-			if (actorRealmId) validated.realm_id = actorRealmId;
+			if (actorRealmId) validated.realmId = actorRealmId;
 		}
 		await actor.permissionEvaluator.evaluate({
 			name: PermissionName.CLIENT_CREATE,
@@ -161,10 +188,14 @@ var ClientService = class extends AbstractEntityService {
 			})
 		});
 		entity = this.repository.create(validated);
-		if (entity.is_confidential) {
+		if (entity.authMethod === ClientAuthMethod.SECRET) {
 			if (!validated.secret) validated.secret = credentialsService.generateSecret();
 			entity.secret = await credentialsService.protect(validated.secret, validated);
-		} else entity.secret = null;
+		} else {
+			entity.secret = null;
+			entity.secretHashed = false;
+			entity.secretEncrypted = false;
+		}
 		await this.repository.save(entity);
 		return {
 			entity,