auth0-deploy-cli 9.0.0-beta.1 → 9.0.0

package/lib/tools/auth0/handlers/clientAuthCredentialsPre.js

@@ -0,0 +1,123 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schema = void 0;
+const default_1 = require("./default");
+const client_1 = require("../client");
+const logger_1 = __importDefault(require("../../../logger"));
+exports.schema = {
+    type: 'array',
+    items: { type: 'object' },
+};
+/**
+ * Handles full credential deletion BEFORE clients.ts (order 50) patches the client.
+ *
+ * Auth0 rejects a client PATCH containing token_endpoint_auth_method while that client still
+ * has active credentials. By running at order 40, this handler clears credentials (and
+ * client_authentication_methods) for any client where the field is absent from config, so
+ * that clients.ts can safely include token_endpoint_auth_method in its PATCH.
+ *
+ * Partial deletion (some credentials removed, others kept) is handled by
+ * ClientAuthCredentialsHandler at order 70, because those clients still have
+ * client_authentication_methods present in config and clients.ts strips token_endpoint_auth_method
+ * for them anyway.
+ */
+class ClientAuthCredentialsPreHandler {
+    constructor({ client, config }) {
+        // Same type as ClientAuthCredentialsHandler so AUTH0_EXCLUDED / AUTH0_INCLUDED_ONLY
+        // applies to both handlers together without needing a separate AssetTypes entry.
+        this.type = 'clientAuthCredentials';
+        this.existing = null;
+        this.client = client;
+        this.config = config;
+    }
+    async getType() {
+        return null;
+    }
+    async load() {
+        return { [this.type]: null };
+    }
+    async validate() {
+        return null;
+    }
+    // Deploy-only pre-pass handler with no dry-run representation. Return empty changes so the
+    // dry-run loop (which calls dryRunChanges on every registered handler) does not crash.
+    async dryRunChanges(_assets) {
+        return { del: [], create: [], conflicts: [], update: [] };
+    }
+    async processChanges(assets) {
+        const { clients } = assets;
+        if (!clients)
+            return;
+        const allowDelete = this.config('AUTH0_ALLOW_DELETE') === true || this.config('AUTH0_ALLOW_DELETE') === 'true';
+        // When allowDelete is false no deletion will happen — skip entirely to avoid
+        // unnecessary GET /credentials calls for every client.
+        if (!allowDelete)
+            return;
+        // Only act on clients where client_authentication_methods is absent from config.
+        // Absent = intentional full deletion. Clients with the field present (including partial
+        // deletion) are fully handled by ClientAuthCredentialsHandler at order 70.
+        const deletionCandidates = clients.filter((c) => c.client_authentication_methods === undefined);
+        if (deletionCandidates.length === 0)
+            return;
+        // In directory mode client_id is stripped. Resolve names once for all candidates.
+        const needsNameResolution = deletionCandidates.some((c) => !c.client_id);
+        let clientIdByName = new Map();
+        if (needsNameResolution) {
+            const existingClients = await (0, client_1.paginate)(this.client.clients.list, {
+                paginate: true,
+                is_global: false,
+            });
+            clientIdByName = new Map(existingClients.map((c) => [c.name, c.client_id]));
+        }
+        for (const client of deletionCandidates) {
+            const clientId = client.client_id || (client.name && clientIdByName.get(client.name));
+            if (!clientId)
+                continue;
+            const clientName = client.name || clientId;
+            let existing = [];
+            try {
+                existing = (await this.client.clients.credentials.list(clientId));
+            }
+            catch (err) {
+                logger_1.default.warn(`clientAuthCredentials: failed to list credentials for client "${clientName}": ${err}`);
+                continue;
+            }
+            if (existing.length === 0)
+                continue;
+            // De-reference credentials from client_authentication_methods before deleting them —
+            // Auth0 rejects deleting a credential that is still referenced.
+            try {
+                await this.client.clients.update(clientId, {
+                    client_authentication_methods: null,
+                    token_endpoint_auth_method: client.token_endpoint_auth_method || 'client_secret_post',
+                });
+            }
+            catch (err) {
+                logger_1.default.warn(`clientAuthCredentials: failed to clear client_authentication_methods on client "${clientName}": ${err}`);
+                continue;
+            }
+            for (const cred of existing) {
+                try {
+                    await this.client.clients.credentials.delete(clientId, cred.id);
+                    logger_1.default.info(`clientAuthCredentials: deleted credential "${cred.name}" on client "${clientName}"`);
+                }
+                catch (err) {
+                    logger_1.default.warn(`clientAuthCredentials: failed to delete credential "${cred.name}" on client "${clientName}": ${err}`);
+                }
+            }
+        }
+    }
+}
+exports.default = ClientAuthCredentialsPreHandler;
+__decorate([
+    (0, default_1.order)('40')
+], ClientAuthCredentialsPreHandler.prototype, "processChanges", null);

package/lib/tools/auth0/handlers/clientGrants.d.ts

@@ -22,7 +22,7 @@ export declare const schema: {
             };
             subject_type: {
                 type: string;
-                enum: ("client" | "user")[];
+                enum: ("client" | "user" | "anonymous_user")[];
                 description: string;
             };
             authorization_details_types: {

package/lib/tools/auth0/handlers/clients.d.ts

@@ -193,10 +193,53 @@ export declare const schema: {
                 };
                 additionalProperties: boolean;
             };
+            identity_assertion_authorization_grant: {
+                type: string;
+                description: string;
+                properties: {
+                    active: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
+            anonymous_sessions: {
+                type: string;
+                description: string;
+                properties: {
+                    active: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
             app_type: {
                 type: string;
                 description: string;
             };
+            b2b_integration_configuration: {
+                type: string[];
+                description: string;
+                properties: {
+                    integration_type: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    sso_profiles: {
+                        type: string;
+                        description: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                };
+                additionalProperties: boolean;
+            };
             resource_server_identifier: {
                 type: string;
                 description: string;
@@ -242,10 +285,39 @@ export declare const schema: {
                         enum: ("allow" | "allow_if_empty")[];
                         description: string;
                     };
+                    third_party_client_access: {
+                        type: string;
+                        description: string;
+                        properties: {
+                            default_value: {
+                                type: string;
+                                enum: "block"[];
+                                description: string;
+                            };
+                            allowed_values: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                    enum: ("allow" | "block")[];
+                                };
+                                uniqueItems: boolean;
+                                description: string;
+                            };
+                        };
+                        required: string[];
+                    };
                     invitation_landing_client_id: {
                         type: string;
                         description: string;
                     };
+                    enforce_permission_ceiling: {
+                        type: string;
+                        description: string;
+                    };
+                    enforce_self_assignment_restriction: {
+                        type: string;
+                        description: string;
+                    };
                 };
                 required: string[];
             };
@@ -328,6 +400,40 @@ export declare const schema: {
                     };
                 };
             };
+            token_vault_privileged_access: {
+                type: string[];
+                description: string;
+                properties: {
+                    ip_allowlist: {
+                        type: string;
+                        description: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    grants: {
+                        type: string;
+                        description: string;
+                        items: {
+                            type: string;
+                            properties: {
+                                connection: {
+                                    type: string;
+                                    description: string;
+                                };
+                                scopes: {
+                                    type: string;
+                                    description: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                };
+                            };
+                            required: string[];
+                        };
+                    };
+                };
+            };
             third_party_security_mode: {
                 type: string;
                 enum: string[];

package/lib/tools/auth0/handlers/clients.js

@@ -59,13 +59,76 @@ const myOrganizationConfigurationSchema = {
             enum: Object.values(auth0_1.Management.ClientMyOrganizationDeletionBehaviorEnum),
             description: 'The deletion behavior for My Organization connections created by this client',
         },
+        third_party_client_access: {
+            type: 'object',
+            description: 'Controls whether third-party clients can access the organization via the My Organization API.',
+            properties: {
+                default_value: {
+                    type: 'string',
+                    enum: Object.values(auth0_1.Management.ClientMyOrganizationConfigurationThirdPartyClientAccessDefaultValueEnum),
+                    description: 'The default third-party client access value.',
+                },
+                allowed_values: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: Object.values(auth0_1.Management.ClientMyOrganizationConfigurationThirdPartyClientAccessAllowedValuesEnum),
+                    },
+                    uniqueItems: true,
+                    description: 'The allowed third-party client access values.',
+                },
+            },
+            required: ['default_value', 'allowed_values'],
+        },
         invitation_landing_client_id: {
             type: 'string',
             description: 'The client ID of the invitation landing client for the My Organization configuration',
         },
+        enforce_permission_ceiling: {
+            type: 'boolean',
+            description: 'When true, limits the permissions that organization admins can assign to members to only those held by the admin themselves. Early Access, gated by the my_org_member_management_ea feature flag.',
+        },
+        enforce_self_assignment_restriction: {
+            type: 'boolean',
+            description: 'When true, prevents organization admins from assigning permissions to themselves. Early Access, gated by the my_org_member_management_ea feature flag.',
+        },
     },
     required: ['allowed_strategies', 'connection_deletion_behavior'],
 };
+const tokenVaultPrivilegedAccessSchema = {
+    type: ['object', 'null'],
+    description: 'Settings for Token Vault Privileged Access, hardening a privileged client by restricting the caller IPs, connections, and scopes it may use at runtime. Early Access, gated by the token_vault_subject_type_jwt_ea_rollout feature flag. Export-only: this object is exported for visibility but is not deployed by the Deploy CLI (it is stripped from create/update payloads because the required credentials are tenant-specific ids). Manage it directly on the tenant.',
+    properties: {
+        ip_allowlist: {
+            type: 'array',
+            description: 'IPv4/IPv6 addresses or CIDR ranges permitted to call token exchange on behalf of this privileged client. When the EA flag is on, this is required (non-empty) on create if token_vault_privileged_access is being set.',
+            items: {
+                type: 'string',
+            },
+        },
+        grants: {
+            type: 'array',
+            description: 'Connection/scope pin objects restricting which federated connections and OAuth scopes the privileged client may use at runtime. Maximum 5 connections; maximum 20 scopes in total across all connections.',
+            items: {
+                type: 'object',
+                properties: {
+                    connection: {
+                        type: 'string',
+                        description: 'The connection name (e.g. google-oauth2). Validated at runtime; the connection need not exist at configuration time.',
+                    },
+                    scopes: {
+                        type: 'array',
+                        description: 'The OAuth scopes permitted for that connection.',
+                        items: {
+                            type: 'string',
+                        },
+                    },
+                },
+                required: ['connection', 'scopes'],
+            },
+        },
+    },
+};
 exports.schema = {
     type: 'array',
     items: {
@@ -221,10 +284,51 @@ exports.schema = {
                 },
                 additionalProperties: true,
             },
+            identity_assertion_authorization_grant: {
+                type: 'object',
+                description: 'Settings for Cross App Access (ID-JAG) token exchange. Early Access. Enables the client to request identity assertion authorization grants.',
+                properties: {
+                    active: {
+                        type: 'boolean',
+                        description: 'Indicates whether the client can request an identity assertion authorization grant (ID-JAG) via token exchange.',
+                    },
+                },
+                required: ['active'],
+                additionalProperties: false,
+            },
+            anonymous_sessions: {
+                type: 'object',
+                description: 'Configuration for anonymous sessions for this client.',
+                properties: {
+                    active: {
+                        type: 'boolean',
+                        description: 'Whether anonymous sessions are enabled for this client.',
+                    },
+                },
+                required: ['active'],
+                additionalProperties: false,
+            },
             app_type: {
                 type: 'string',
                 description: 'The type of application this client represents',
             },
+            b2b_integration_configuration: {
+                type: ['object', 'null'],
+                description: 'B2B integration configuration. Early Access. Required feature flag: enterprise_connect_entitled.',
+                properties: {
+                    integration_type: {
+                        type: 'string',
+                        enum: ['custom_auth_server', 'third_party', 'application'],
+                        description: 'The type of integration used to connect to this B2B integration client.',
+                    },
+                    sso_profiles: {
+                        type: 'array',
+                        description: 'List of SSO profile IDs linked to this B2B integration client. Maximum 1 entry.',
+                        items: { type: 'string' },
+                    },
+                },
+                additionalProperties: false,
+            },
             resource_server_identifier: {
                 type: 'string',
                 description: 'The identifier of a resource server in your tenant. This property links a client to a resource server indicating that the client IS that resource server. Can only be set when app_type=resource_server.',
@@ -332,6 +436,7 @@ exports.schema = {
                     },
                 },
             },
+            token_vault_privileged_access: tokenVaultPrivilegedAccessSchema,
             third_party_security_mode: {
                 type: 'string',
                 enum: ['strict', 'permissive'],
@@ -460,6 +565,40 @@ const createClientSanitizer = (clients) => {
         },
     };
 };
+/**
+ * On export, remove `credentials` from `token_vault_privileged_access`.
+ *
+ * Auth0 returns these as tenant-specific credential references (`{ id }`) — never
+ * names or key material — so they are not portable across tenants and must never be
+ * written to disk. `ip_allowlist` and `grants` are kept for visibility. Mutates and
+ * returns the same client.
+ */
+const stripTokenVaultCredentialsOnExport = (client) => {
+    const tvpa = client
+        .token_vault_privileged_access;
+    if (tvpa && 'credentials' in tvpa) {
+        delete tvpa.credentials;
+    }
+    return client;
+};
+/**
+ * On write (create/update), remove the entire `token_vault_privileged_access` object.
+ *
+ * The Management API requires `credentials` whenever `token_vault_privileged_access`
+ * is present in the payload, but those credentials are tenant-specific ids that the
+ * Deploy CLI intentionally never persists (see stripTokenVaultCredentialsOnExport).
+ * Sending the object without `credentials` fails validation ("Missing required
+ * property: credentials"); sending it with exported ids would re-send stale ids on a
+ * cross-tenant deploy. The Deploy CLI therefore does not manage this field — it is
+ * export-only. Manage `token_vault_privileged_access` directly on the tenant.
+ * Mutates and returns the same client.
+ */
+const stripTokenVaultPrivilegedAccessOnWrite = (client) => {
+    if ('token_vault_privileged_access' in client) {
+        delete client.token_vault_privileged_access;
+    }
+    return client;
+};
 class ClientHandler extends default_1.default {
     constructor(config) {
         super({
@@ -482,6 +621,9 @@ class ClientHandler extends default_1.default {
                 'jwks_uri',
                 // third_party_security_mode is immutable after creation; PATCH returns 400
                 'third_party_security_mode',
+                // API-generated timestamps; PATCH returns 400 if present
+                'created_at',
+                'updated_at',
             ],
             functions: {
                 create: (client) => this.createClient(client),
@@ -566,6 +708,21 @@ class ClientHandler extends default_1.default {
                         delete item.refresh_token;
                     }
                 }
+                // Strip client_authentication_methods — the clientAuthCredentials handler (order 70)
+                // owns this field entirely. Auth0 rejects credential objects with name/credential_type in PATCH.
+                // Strip token_endpoint_auth_method only when client_authentication_methods is present in config:
+                // Auth0 rejects it in PATCH while a client has active credentials. For these clients the
+                // clientAuthCredentials handler (order 70) owns token_endpoint_auth_method too.
+                // For clients without client_authentication_methods, credentials were already cleared by
+                // clientAuthCredentialsPre (order 40), so token_endpoint_auth_method passes through safely.
+                if (item.client_authentication_methods) {
+                    delete item.token_endpoint_auth_method;
+                }
+                delete item.client_authentication_methods;
+                // token_vault_privileged_access requires tenant-specific credential ids that
+                // the Deploy CLI never persists. Strip the whole object on write so we neither
+                // re-send stale ids nor fail validation for the missing credentials property.
+                stripTokenVaultPrivilegedAccessOnWrite(item);
                 return item;
             });
         };
@@ -587,7 +744,38 @@ class ClientHandler extends default_1.default {
             is_global: false,
             ...((0, utils_1.shouldExcludeThirdPartyClients)(this.config) && { is_first_party: true }),
         });
-        this.existing = createClientSanitizer(clients).sanitizeCrossOriginAuth(false).get();
+        const sanitized = createClientSanitizer(clients)
+            .sanitizeCrossOriginAuth(false)
+            .get()
+            // token_vault_privileged_access.credentials are returned as tenant-specific
+            // ids — strip them so they are never exported to disk.
+            .map(stripTokenVaultCredentialsOnExport);
+        // Enrich credential stubs with name and credential_type for export.
+        // Auth0 does not return pem on read — it is never exported.
+        await Promise.all(sanitized.map(async (client) => {
+            if (!client.client_authentication_methods)
+                return;
+            try {
+                const creds = await this.client.clients.credentials.list(client.client_id);
+                const credMap = new Map(creds.map((c) => [c.id, c]));
+                Object.values(client.client_authentication_methods).forEach((method) => {
+                    if (method?.credentials) {
+                        method.credentials = method.credentials
+                            .map((stub) => {
+                            const full = credMap.get(stub.id);
+                            if (!full?.name)
+                                return null;
+                            return { name: full.name, credential_type: full.credential_type };
+                        })
+                            .filter(Boolean);
+                    }
+                });
+            }
+            catch (_) {
+                // leave stubs as-is if the credentials API call fails
+            }
+        }));
+        this.existing = sanitized;
         return this.existing;
     }
     isCimdClient(client) {
@@ -625,7 +813,23 @@ class ClientHandler extends default_1.default {
     async updateClient(clientId, client) {
         // For non-CIMD clients
         if (!this.isCimdClient(client)) {
-            return this.client.clients.update(clientId, client);
+            const payload = { ...client };
+            // b2b_integration_configuration: PATCH only allowed if client already has the object.
+            // Sending it to a client that lacks it returns 400 invalid_body.
+            // null clears the object — but only for clients that already have it; stripping
+            // null for a client without the field is a safe no-op.
+            if ('b2b_integration_configuration' in payload) {
+                const existing = (this.existing || []).find((c) => c.client_id === (client.client_id || clientId));
+                if (!existing?.b2b_integration_configuration) {
+                    if (payload.b2b_integration_configuration !== null) {
+                        logger_1.default.warn(`b2b_integration_configuration cannot be added to an existing client via PATCH ` +
+                            `(client: ${client.name || clientId}). Skipping field. ` +
+                            `Re-create the client to set this field.`);
+                    }
+                    delete payload.b2b_integration_configuration;
+                }
+            }
+            return this.client.clients.update(clientId, payload);
         }
         const updatePayload = this.getCIMDEditableFields(client);
         const registrationClientId = client.client_id || clientId;

package/lib/tools/auth0/handlers/connectionProfiles.d.ts

@@ -36,6 +36,33 @@ export declare const schema: {
             connection_config: {
                 type: string[];
             };
+            cross_app_access_resource_app: {
+                type: string;
+                description: string;
+                properties: {
+                    status: {
+                        type: string;
+                        properties: {
+                            default_value: {
+                                type: string;
+                                enum: ("enabled" | "disabled")[];
+                                description: string;
+                            };
+                            allowed_values: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                    enum: ("enabled" | "disabled")[];
+                                };
+                                uniqueItems: boolean;
+                                description: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                required: string[];
+            };
             strategy_overrides: {
                 type: string[];
                 properties: {

package/lib/tools/auth0/handlers/connectionProfiles.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConnectionProfile = exports.schema = void 0;
+const auth0_1 = require("auth0");
 const default_1 = __importDefault(require("./default"));
 const client_1 = require("../client");
 const logger_1 = __importDefault(require("../../../logger"));
@@ -42,6 +43,35 @@ exports.schema = {
             connection_config: {
                 type: ['object', 'null'],
             },
+            cross_app_access_resource_app: {
+                type: 'object',
+                description: 'Controls whether organization admins may enable Cross App Access (XAA) on their Identity Providers.',
+                properties: {
+                    status: {
+                        type: 'object',
+                        properties: {
+                            default_value: {
+                                type: 'string',
+                                enum: Object.values(auth0_1.Management.ConnectionProfileCrossAppAccessResourceAppStatusDefaultValueEnum),
+                                description: 'The default Cross App Access resource app status.',
+                            },
+                            allowed_values: {
+                                type: 'array',
+                                items: {
+                                    type: 'string',
+                                    enum: Object.values(auth0_1.Management.ConnectionProfileCrossAppAccessResourceAppStatusValueEnum),
+                                },
+                                uniqueItems: true,
+                                description: 'The allowed Cross App Access resource app status values.',
+                            },
+                        },
+                        // allowed_values is optional per the SDK type (unlike the client's
+                        // third_party_client_access, which requires both fields).
+                        required: ['default_value'],
+                    },
+                },
+                required: ['status'],
+            },
             strategy_overrides: {
                 type: ['object', 'null'],
                 properties: {