> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/settings/key-store.md).

# Almacén de claves

Settings › Key Store guarda valores con nombre, como una URL de descarga o el nombre de una cuenta de servicio, que scripts, acciones de URL y webhooks leen por su nombre sin repetirlos.

## Qué es y cuándo usarlo

El almacén de claves es una lista global de valores con nombre. Un argumento de script, una variable de entorno de script, una acción de URL o un webhook hace referencia a un valor por su nombre con `{{global.NAME}}`, y SONAR pone el valor en su lugar cuando se ejecuta el script o la acción.

Úselo para cualquier valor que compartan muchos scripts y que pueda cambiar: una URL de descarga, la dirección de un servicio interno, un identificador de inquilino, el nombre de una cuenta de servicio. Cuando el valor cambia, usted edita una sola clave, y todos los scripts y acciones que hacen referencia a ella toman el nuevo valor en su siguiente ejecución.

El almacén de claves es global: sus claves son las mismas para todos los clientes y sitios.

## Antes de empezar

* Su rol necesita **View Core Settings** para abrir **Settings**, **View Global Keystore** para ver las claves y **Edit Global Keystore** para añadirlas, editarlas o eliminarlas (grupos **Settings** y **Security** en **Admin Center › Roles**).
* Cualquier persona cuyo rol tenga **View Global Keystore** puede mostrar los valores con **Show values**. Guarde en él solo lo que esos usuarios pueden leer.

## Pasos

### Añadir una clave

1. Abra **Admin Center › Settings** y la pestaña **Key Store**.
2. Haga clic en **Add key**.
3. En **Add Global Key**, escriba el **Name**, por ejemplo `API_BASE`.
4. Escriba el **Value**. El icono del ojo muestra lo que escribe.
5. Haga clic en **Submit**.

### Usar una clave

Escriba `{{global.NAME}}` donde debe ir el valor:

* en un argumento o una variable de entorno de script, al ejecutar un script en un dispositivo, en una acción masiva, en una tarea automatizada o en una acción de plantilla de alerta;
* en la URL de una acción de URL; vea [Acciones de URL](/es/sonar/administration/settings/url-actions.md);
* en la URL, los encabezados o el cuerpo de un webhook; vea [Webhooks](/es/sonar/administration/settings/webhooks.md).

Por ejemplo, con una clave `API_BASE` cuyo valor es `https://api.example.com`, el argumento `-Url {{global.API_BASE}}` llega a un script de PowerShell como `-Url 'https://api.example.com'`. Las reglas de entrecomillado y las demás variables están en [Variables de script](/es/sonar/reference/script-variables.md).

### Editar o eliminar una clave

1. Haga doble clic en la clave para abrir **Edit Global Key**, cambie el **Name** o el **Value** y haga clic en **Submit**.
2. Para eliminarla, haga clic con el botón derecho en la clave, elija **Delete** y confirme con **Delete** en **Delete key: NAME?**.

Los cambios se aplican en la siguiente ejecución de cada script o acción. Los scripts y acciones que todavía hacen referencia a una clave eliminada o renombrada dejan de recibir su valor.

## Qué debe ver

El recuadro **Global Key Store** lista cada clave con su **Name** y su **Value** oculto como `****`. **Show values** muestra los valores y **Hide values** vuelve a ocultarlos. Sin claves, la tabla indica **No Keys added yet**.

Al añadir, editar y eliminar una clave se muestran **Key was added!**, **Key was edited!** y **Key NAME was deleted!**.

## Cómo verificar que funcionó

1. Cree un script de prueba que imprima su primer argumento, por ejemplo `Write-Output $args[0]` en PowerShell; vea [Biblioteca de scripts](/es/sonar/administration/automation/scripts.md).
2. Ejecútelo en un dispositivo de prueba con el argumento `{{global.NAME}}`, esperando la salida; vea [Ejecutar un comando o un script en un dispositivo](/es/sonar/administration/automation/run-commands-and-scripts.md).
3. La salida debe mostrar el valor de la clave, no el texto `{{global.NAME}}`.
4. En **Reports & Audits › Audits**, una entrada **Add Object** o **Modify Object** cuyo mensaje nombra la clave registra quién la cambió; vea [Registro de auditoría](/es/sonar/administration/audit/audit-trail.md).

## Errores comunes

| Síntoma                                                    | Causa                                                                  | Solución                                                                       |
| ---------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| El script recibe `{{global.NAME}}` como texto              | Ninguna clave tiene exactamente ese nombre                             | Revise la ortografía y las mayúsculas y minúsculas del nombre en **Key Store** |
| **Failed to add key** con un mensaje sobre la longitud     | **Name** tiene más de 25 caracteres                                    | Use un nombre más corto                                                        |
| **\*Required** bajo **Name** o **Value**                   | El campo está vacío                                                    | Rellene ambos campos                                                           |
| **Failed to load key store**                               | El rol no tiene **View Global Keystore**                               | Conceda ese permiso en **Admin Center › Roles**                                |
| **Add key** falla para un usuario que puede ver las claves | El rol tiene **View Global Keystore** pero no **Edit Global Keystore** | Conceda **Edit Global Keystore**                                               |
| Un script toma el valor equivocado                         | Dos claves tienen el mismo nombre                                      | Mantenga cada nombre único; renombre o elimine la duplicada                    |

## Referencia de campos

| Campo     | Qué hace                                     | Valores aceptados                                                                                            | Valor por defecto |
| --------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------- |
| **Name**  | El nombre usado en `{{global.NAME}}`         | Hasta 25 caracteres. Use letras, dígitos, guiones bajos y guiones, y mantenga cada nombre único. Obligatorio | Vacío             |
| **Value** | El texto que se pone en lugar de la variable | Cualquier texto. Obligatorio                                                                                 | Vacío             |

## Páginas relacionadas

* [Variables de script](/es/sonar/reference/script-variables.md): todas las variables que pueden usar los scripts, y cómo se entrecomillan los valores
* [Biblioteca de scripts](/es/sonar/administration/automation/scripts.md): scripts que reciben argumentos
* [Acciones de URL](/es/sonar/administration/settings/url-actions.md): enlaces que pueden incluir valores del almacén de claves
* [Webhooks](/es/sonar/administration/settings/webhooks.md): solicitudes que pueden incluir valores del almacén de claves
* [Roles y permisos](/es/sonar/administration/identities/roles.md): **View Global Keystore** y **Edit Global Keystore**