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
Abra Admin Center › Settings y la pestaña Key Store.
Haga clic en Add key.
En Add Global Key, escriba el Name, por ejemplo
API_BASE.Escriba el Value. El icono del ojo muestra lo que escribe.
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;
en la URL, los encabezados o el cuerpo de un webhook; vea Webhooks.
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.
Editar o eliminar una clave
Haga doble clic en la clave para abrir Edit Global Key, cambie el Name o el Value y haga clic en Submit.
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ó
Cree un script de prueba que imprima su primer argumento, por ejemplo
Write-Output $args[0]en PowerShell; vea Biblioteca de scripts.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.La salida debe mostrar el valor de la clave, no el texto
{{global.NAME}}.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.
Errores comunes
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
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: todas las variables que pueden usar los scripts, y cómo se entrecomillan los valores
Biblioteca de scripts: scripts que reciben argumentos
Acciones de URL: enlaces que pueden incluir valores del almacén de claves
Webhooks: solicitudes que pueden incluir valores del almacén de claves
Roles y permisos: View Global Keystore y Edit Global Keystore
Atualizado
Isto foi útil?