> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Aprenda a configurar Auth0 Deploy CLI para adaptar la herramienta a sus necesidades.

# Configurar Deploy CLI

Configurar Deploy CLI es fundamental para establecer las credenciales de Auth0 y, en general, adaptar el comportamiento de la herramienta a sus necesidades específicas. Hay dos formas de configurar Deploy CLI:

1. Usar el archivo de configuración (`config.json`).
2. Establecer variables de entorno.

<div id="configuration-file">
  ## Archivo de configuración
</div>

Puede usar un archivo JSON independiente para configurar Deploy CLI. Normalmente, este archivo se encuentra en el directorio raíz de su proyecto y debe llamarse `config.json`.

### Ejemplo

```json lines theme={null}
{
  "AUTH0_DOMAIN": "<YOUR_TENANT_DOMAIN>",
  "AUTH0_CLIENT_ID": "{yourClientId}",
  "AUTH0_ALLOW_DELETE": false
}
```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  No se recomienda incluir credenciales de forma fija en el código, ya que existe el riesgo de que los secretos se filtren si este archivo llega a confirmarse en un sistema público de control de versiones. Para mitigar este riesgo, como práctica recomendada, pase las credenciales como [variables de entorno](#environment-variables).
</Callout>

<div id="environment-variables">
  ## Variables de entorno
</div>

De forma predeterminada, Deploy CLI lee las variables de entorno, lo que permite pasar credenciales y otras opciones de configuración a la herramienta sin necesidad de publicarlas en el archivo `config.json`. Las variables de entorno pueden usarse para complementar el archivo `config.json` o sustituirlo por completo, según las necesidades del proyecto.

Los valores de configuración no primitivos, como `AUTH0_KEYWORD_REPLACE_MAPPINGS` y `AUTH0_EXCLUDED`, también pueden pasarse mediante variables de entorno, siempre que estén correctamente serializados como JSON.

Para deshabilitar el uso de variables de entorno en los comandos `import` o `export`, pase el argumento `--env=false`.

<div id="examples">
  ### Ejemplos
</div>

<div id="deploying-configuration-for-yaml-formats-without-a-configjson-file">
  #### Despliegue de la configuración para formatos YAML sin un archivo config.json
</div>

```bash lines theme={null}
$ export AUTH0_DOMAIN={yourDomain}
$ export AUTH0_CLIENT_ID={yourClientId}
$ export AUTH0_CLIENT_SECRET={yourClientSecret}
$ a0deploy import --input_file=local/tenant.yaml
```

<div id="disable-environment-variable-ingestion">
  #### Deshabilitar la carga de variables de entorno
</div>

```bash wrap lines theme={null}
$ a0deploy export -c=config.json --format=yaml --output_folder=local --env=false
```

<div id="non-primitive-configuration-values">
  #### Valores de configuración no primitivos
</div>

```bash lines theme={null}
$ export AUTH0_EXCLUDED='["actions","organizations"]'
$ export AUTH0_KEYWORD_REPLACE_MAPPINGS='{"ENVIRONMENT":"dev"}'
$ a0deploy export -c=config.json --format=yaml --output_folder=local
```

<div id="available-configuration-properties">
  ## Propiedades de configuración disponibles
</div>

<div id="auth0_domain">
  ### AUTH0\_DOMAIN
</div>

Cadena. El dominio del inquilino de destino de Auth0.

<div id="auth0_client_id">
  ### AUTH0\_CLIENT\_ID
</div>

Cadena. El id de la aplicación de Auth0 especificada que se usa para realizar solicitudes a la API.

<div id="auth0_client_secret">
  ### AUTH0\_CLIENT\_SECRET
</div>

Cadena. El secreto de la aplicación de Auth0 especificada que se usa para realizar solicitudes a la API.

<div id="auth0_access_token">
  ### AUTH0\_ACCESS\_TOKEN
</div>

Cadena. <Tooltip tip="Token de acceso: Credencial de autorización, en forma de una cadena opaca o JWT, utilizada para acceder a una API." cta="Ver glosario" href="/es/docs/glossary?term=access+token">token de acceso</Tooltip> de corta duración para <Tooltip tip="Token de acceso: Credencial de autorización, en forma de una cadena opaca o JWT, utilizada para acceder a una API." cta="Ver glosario" href="/es/docs/glossary?term=Management+API">Management API</Tooltip> de la aplicación de Auth0 especificada. Se puede usar en lugar de la combinación de <Tooltip tip="ID de cliente: Valor de identificación asignado por Auth0 a su recurso registrado." cta="Ver glosario" href="/es/docs/glossary?term=client+ID">ID de cliente</Tooltip> y <Tooltip tip="ID de cliente: Valor de identificación asignado por Auth0 a su recurso registrado." cta="Ver glosario" href="/es/docs/glossary?term=client+secret">Secreto del cliente</Tooltip>.

<div id="auth0_client_signing_key_path">
  ### AUTH0\_CLIENT\_SIGNING\_KEY\_PATH
</div>

Cadena. La ruta de acceso a la clave privada que utiliza el cliente para la autenticación con Private Key <Tooltip tip="JSON Web Token (JWT): formato estándar de ID Token (y, a menudo, de Token de acceso) utilizado para representar reclamaciones de forma segura entre dos partes." cta="Ver glosario" href="/es/docs/glossary?term=JWT">JWT</Tooltip>. Ruta relativa al directorio de trabajo. Consulte también `AUTH0_CLIENT_SIGNING_ALGORITHM` para especificar el <Tooltip tip="Algoritmo de firma: algoritmo utilizado para firmar digitalmente tokens y garantizar que el token no haya sido manipulado." cta="Ver glosario" href="/es/docs/glossary?term=signing+algorithm">algoritmo de firma</Tooltip>.

<div id="auth0_client_signing_algorithm">
  ### AUTH0\_CLIENT\_SIGNING\_ALGORITHM
</div>

Cadena. Especifica los algoritmos de firma de JWT que usa el cliente al llevar a cabo la autenticación con Private Key JWT. Solo se usa en combinación con `AUTH0_CLIENT_SIGNING_KEY_PATH`.

Valores aceptados: `RS256`, `RS384`, `PS256`.

<div id="auth0_allow_delete">
  ### AUTH0\_ALLOW\_DELETE
</div>

Booleano. Cuando está habilitado, permite que la herramienta elimine recursos. Predeterminado: `false`.

<div id="auth0_excluded">
  ### AUTH0\_EXCLUDED
</div>

Array de cadenas. Excluye tipos de recursos completos de ser administrados bidireccionalmente. Para obtener más información, consulte [Excluir recursos de la administración](/es/docs/deploy-monitor/deploy-cli-tool/exclude-resources-from-management).

No puede usarse simultáneamente con [AUTH0\_INCLUDED\_ONLY](#auth0_included_only).

Valores posibles: `actions`, `attackProtection`, `branding`, `clientGrants`, `clients`, `connections`, `customDomains`, `databases`, `emailProvider`, `emailTemplates`, `guardianFactorProviders`, `guardianFactorTemplates`, `guardianFactors`, `guardianPhoneFactorMessageTypes`, `guardianPhoneFactorSelectedProvider`, `guardianPolicies`, `logStreams`, `migrations`, `organizations`, `pages`, `prompts`, `resourceServers`, `roles`, `tenant`, `triggers`.

<div id="example">
  #### Ejemplo
</div>

```json lines theme={null}
{
  "AUTH0_EXCLUDED": ["organizations", "connections", "hooks"]
}
```

<div id="auth0_included_only">
  ### AUTH0\_INCLUDED\_ONLY
</div>

Array de cadenas. Especifica qué tipos de recursos se gestionarán de forma bidireccional. Para obtener más información, consulte [excluir recursos de la administración](/es/docs/deploy-monitor/deploy-cli-tool/exclude-resources-from-management).

No puede usarse simultáneamente con [AUTH0\_EXCLUDED](#auth0_excluded).

Valores posibles: `actions`, `attackProtection`, `branding`, `clientGrants`, `clients`, `connections`, `customDomains`, `databases`, `emailProvider`, `emailTemplates`, `guardianFactorProviders`, `guardianFactorTemplates`, `guardianFactors`, `guardianPhoneFactorMessageTypes`, `guardianPhoneFactorSelectedProvider`, `guardianPolicies`, `logStreams`, `migrations`, `organizations`, `pages`, `prompts`, `resourceServers`, `roles`, `tenant`, `triggers`.

<div id="example">
  #### Ejemplo
</div>

```json lines theme={null}
{
  "AUTH0_INCLUDED_ONLY": ["clients", "connections", "tenant", "branding"]
}
```

<div id="auth0_keyword_replace_mappings">
  ### AUTH0\_KEYWORD\_REPLACE\_MAPPINGS
</div>

Asignación de palabras clave específicas para facilitar su reemplazo dinámico. Para obtener más información, consulte [Reemplazo de palabras clave](/es/docs/deploy-monitor/deploy-cli-tool/keyword-replacement).

<div id="example">
  #### Ejemplo
</div>

```json lines theme={null}
{
  "ENVIRONMENT": "DEV",
  "ALLOWED_ORIGINS": ["https://dev.test-site.com", "localhost"]
}
```

<div id="auth0_preserve_keywords">
  ### AUTH0\_PRESERVE\_KEYWORDS
</div>

Booleano. Cuando está habilitado, intentará conservar los marcadores de sustitución de palabras clave en los archivos de recursos locales durante la exportación. De lo contrario, los valores remotos sobrescribirán esos marcadores de palabras clave colocados manualmente.

Esta configuración requiere la presencia de archivos de configuración locales y asignaciones de sustitución de palabras clave definidas mediante la propiedad de configuración `AUTH0_KEYWORD_REPLACE_MAPPINGS`.

Consulte también: [Conservar palabras clave en la exportación](/es/docs/deploy-monitor/deploy-cli-tool/keyword-replacement#preserve-keywords-on-export).

<div id="auth0_export_identifiers">
  ### AUTH0\_EXPORT\_IDENTIFIERS
</div>

Booleano. Cuando está habilitado, devuelve los identificadores de todos los recursos. Puede resultar útil en determinados escenarios de depuración o mantenimiento de registros dentro de un contexto de inquilino único. Valor predeterminado: `false`.

<div id="excluded_props">
  ### EXCLUDED\_PROPS
</div>

Permite excluir de la administración cualquier propiedad no deseada.

<div id="example">
  #### Ejemplo
</div>

```json lines theme={null}
{
  "connections": ["options.twilio_token"]
}
```

<div id="auth0_audience">
  ### AUTH0\_AUDIENCE
</div>

Cadena. Valor independiente del valor de <Tooltip tip="Audiencia: Identificador único de la audiencia de un token emitido. Se denomina aud en un token; su valor contiene el ID de una aplicación (ID de cliente) para un ID Token o de una API (Identificador de API) para un Token de acceso." cta="Ver glosario" href="/es/docs/glossary?term=audience">audiencia</Tooltip> al recuperar un token de acceso para la Management API. Resulta útil cuando los endpoints predeterminados de la Management API no están expuestos públicamente.

<div id="auth0_excluded_rules">
  ### AUTH0\_EXCLUDED\_RULES
</div>

Array de cadenas. Excluye la gestión de Rules específicas por id. Nota: Esta configuración puede quedar obsoleta en el futuro. Para obtener más información, consulte [Excluir recursos de la administración](/es/docs/deploy-monitor/deploy-cli-tool/exclude-resources-from-management).

<div id="auth0_excluded_clients">
  ### AUTH0\_EXCLUDED\_CLIENTS
</div>

Array de cadenas. Excluye de la administración clientes específicos por ID. Nota: Esta configuración podría quedar obsoleta en el futuro. Para obtener más información, consulte [Excluir recursos de la administración](/es/docs/deploy-monitor/deploy-cli-tool/exclude-resources-from-management).

<div id="auth0_excluded_databases">
  ### AUTH0\_EXCLUDED\_DATABASES
</div>

Array de cadenas. Excluye la administración de bases de datos específicas por ID. Nota: Esta configuración podría quedar obsoleta en el futuro. Para obtener más información, consulte [Excluir recursos de la administración](/es/docs/deploy-monitor/deploy-cli-tool/exclude-resources-from-management).

<div id="auth0_excluded_connections">
  ### AUTH0\_EXCLUDED\_CONNECTIONS
</div>

Array de cadenas. Excluye la administración de conexiones específicas por ID. Nota: Esta configuración podría quedar obsoleta en el futuro. Para obtener más información, consulte [Excluir recursos de la administración](/es/docs/deploy-monitor/deploy-cli-tool/exclude-resources-from-management).

<div id="auth0_excluded_resource_servers">
  ### AUTH0\_EXCLUDED\_RESOURCE\_SERVERS
</div>

Array de cadenas. Excluye la administración de <Tooltip tip="Servidor de recursos: servidor que aloja recursos protegidos. Los servidores de recursos aceptan y responden a solicitudes de recursos protegidos." cta="Ver glosario" href="/es/docs/glossary?term=resource+servers">servidores de recursos</Tooltip> específicos por ID. Nota: esta configuración puede quedar obsoleta en el futuro. Para obtener más información, consulte [Excluir recursos de la administración](/es/docs/deploy-monitor/deploy-cli-tool/exclude-resources-from-management).