---
title: devicecustomization
slug: develop/es/devicecustomization
docTags: 
createdAt: 2025-03-11T07:07:19.526Z
---

Este objeto proporciona un método para cifrar almacenamiento y se publicó en la versión 9.0.146 de BOS.

**IDL de devicecustomization**

```text
interface DeviceCustomization {
    Promise<void> encryptStorage(String device, StorageEncryptionOptions params);
};

interface StorageEncryptionOptions {
attribute String method;
attribute String passphrase;
attribute Boolean format;
};
```

## Creación de objetos

```javascript
let DeviceCustomizationClass = require("@brightsign/devicecustomization");
let devicecustomization = new DeviceCustomizationClass();
```

## DeviceCustomization

### encryptStorage()

```javascript
Promise<void> encryptStorage(String device, StorageEncryptionOptions params)
```

Cifra el contenido de un dispositivo de almacenamiento utilizando una clave de cifrado almacenada en la sección privada del registro del reproductor. Esto evita que otros dispositivos lean los nombres o contenidos de los archivos en el dispositivo de almacenamiento (aunque los metadatos de los archivos seguirán siendo legibles). El dispositivo de almacenamiento aún puede montarse en otros dispositivos, que pueden listar, eliminar y copiar archivos (aunque no puedan leerlos).

El parámetro device especifica qué unidad de almacenamiento cifrar (por ejemplo, `/storage/sd`, `/storage/usb1`, `/storage/ssd`), y el proceso se configura con los parámetros de *StorageEncryptionOptions* pasados.

## StorageEncryptionOptions

### Atributos

- `método` <font color="#704ae0">string</font>: El método de cifrado, que puede ser uno de los siguientes:
  - `"ninguno"`: El cifrado está deshabilitado y cualquier clave de cifrado para el dispositivo de almacenamiento se elimina del registro. 
  - `"frase de contraseña"`: El dispositivo de almacenamiento se cifra utilizando una frase de contraseña sin ofuscar.
  - `"obfuscated_passphrase"`: El dispositivo de almacenamiento se cifra utilizando una frase de contraseña ofuscada. Contacte con [support@brightsign.biz](mailto\:support@brightsign.biz) para obtener más información sobre cómo generar una clave para la ofuscación y almacenarla en el reproductor. 
  - `"brightsign_key"`: El dispositivo de almacenamiento se cifra utilizando una clave de cifrado común para todos los reproductores BrightSign, pero que no se comparte con partes externas. 
  - `"generate_key"`: El dispositivo de almacenamiento se cifra utilizando una clave de cifrado que se genera bajo demanda mediante un generador aleatorio seguro. El registro privado del reproductor contiene la única copia de la clave; si el valor del registro se borra o se corrompe, no habrá forma de recuperar los datos de ese dispositivo de almacenamiento. El registro privado no distingue entre diferentes volúmenes físicos de la misma unidad. Por ejemplo, si cifra dos tarjetas SD, la clave de la primera tarjeta SD se sobrescribirá cuando se cifre la segunda tarjeta SD; en el caso de una clave generada aleatoriamente, los datos de la primera tarjeta SD serán irrecuperables.
- `frase de contraseña` <font color="#704ae0">string</font>: La frase de contraseña para cifrar el dispositivo de almacenamiento. Este parámetro debe incluirse si el método se especifica como `"frase de contraseña"` o `"obfuscated_passphrase"`. 
- `formato` <font color="#704ae0">boolean</font>: Establecer esto en `verdadero` hará que el dispositivo de almacenamiento especificado se reformatee; todos los archivos existentes se eliminarán (pero no se garantiza que se borren de forma segura) antes de cifrar el dispositivo; sin embargo, si el dispositivo no puede reformatearse, la operación fallará. Si se establece en `falso`, el dispositivo de almacenamiento se montará como si hubiera sido cifrado previamente utilizando la clave proporcionada.
  - Si el dispositivo de almacenamiento no se ha cifrado previamente, se cifrará dejando cualquier archivo preexistente sin cifrar. Si el dispositivo de almacenamiento se ha cifrado utilizando una clave diferente, la operación fallará.
  - Si el parámetro `formato` no se especifica, el dispositivo de almacenamiento se montará como si hubiera sido cifrado previamente utilizando la clave proporcionada. Si el dispositivo de almacenamiento no se ha cifrado previamente, la operación fallará.