# Cómo realizar aperturas en Salto Nebula
> Aprende a abrir puertas utilizando la aplicación Nebula Keychain y otros métodos de apertura disponibles en el sistema de control de accesos Nebula.


## Descripción general {#overview}

En Salto Nebula, puedes abrir puertas de varias maneras, según cómo tu emisor de llaves haya configurado tu acceso:

- **Aplicación móvil** - El método más común, que utiliza Bluetooth para abrir puertas de forma inalámbrica
- **NFC** - Acerca y mantén tu teléfono cerca de los lectores de puertas compatibles para un acceso rápido sin abrir la aplicación
- **Teclados** - Introduce un código PIN en las puertas equipadas con teclados
- **Llaves físicas** - Utiliza tarjetas o llaveros si tu emisor de llaves te los ha asignado

Esta guía se centra principalmente en la apertura de puertas mediante la aplicación Nebula Keychain.

La sección **Mis llaves** de la aplicación se adapta automáticamente en función de tus permisos de acceso y las puertas cercanas.

![Ejemplo de Mis llaves](images/my-keys-example.png "La sección 'Mis llaves' de la aplicación Nebula Keychain varía según el acceso y las llaves que se te hayan asignado")
{.border}

## Comprender la pantalla «Mis llaves» {#understanding-my-keys}

Cuando abres la aplicación Nebula Keychain, la pantalla **Mis llaves** se mostrará de diferentes maneras según tu situación:

### Al buscar puertas {#searching-for-doors}

Cuando la aplicación está abierta y busca activamente puertas cercanas a través de Bluetooth, generalmente verás lo siguiente:

- Una lista de las puertas a las que tienes acceso o solo una «tarjeta» que representa un único acceso; esto puede cubrir una puerta o varias puertas que se abren conjuntamente
- Las puertas dentro del rango (que se pueden abrir) se marcan como **Cercana** con un icono de Bluetooth
- Las puertas que están fuera de rango (estas no se pueden abrir) aparecen en la lista pero con un estado **Fuera de rango**

![Ejemplo de puertas que están fuera de rango](images/out-of-range.png "Ejemplo de puertas que están fuera de rango en la aplicación Nebula Keychain")
{.border}

A medida que las puertas entren en el rango de Bluetooth, su estado se actualizará en tiempo real de **Fuera de rango** a **Cercana**, lo que te permitirá abrirlas.

**Consejo:** Toca el botón de actualizar en la parte superior de la pantalla para reiniciar manualmente el proceso de escaneo Bluetooth y comprobar si hay nuevas llaves o permisos de acceso que se te hayan asignado.

{{% info-panel %}}
La aplicación puede mostrar hasta 15 puertas a la vez.
Si tienes acceso a más ubicaciones, solo se mostrarán las puertas cercanas que estén dentro del rango de Bluetooth.
{{% /info-panel %}}

### Diferentes escenarios de visualización de puertas {#door-scenarios}

La aplicación se adapta automáticamente según el número de puertas a las que puedes acceder:

- **Acceso único**: Se muestra una tarjeta con el nombre del acceso y un botón de **Abrir** o **Cerrar** de ancho completo, aunque algunos tipos de acceso pueden abrir más de una puerta desde la misma tarjeta
- **De 2 a 5 puertas**: Aparece una lista que muestra todas las puertas accesibles, estén o no en el rango
- **Más de 5 puertas**: Se habilitan funciones adicionales para ayudarte a gestionar tu acceso:
  - Aparece una **barra de búsqueda** en la parte superior para ayudarte a encontrar puertas específicas
  - Las puertas aparecen en la lista a medida que entran en el rango de Bluetooth y luego se ordenan por la intensidad de la señal, apareciendo primero las puertas más cercanas

{{% info-panel %}}
La aplicación puede mostrar hasta 15 puertas a la vez.
Si tienes acceso a más ubicaciones, solo se mostrarán las puertas cercanas que estén dentro del rango de Bluetooth.
{{% /info-panel %}}

### Botones de cierre y apertura {#lock-unlock-buttons}

Dependiendo de las capacidades de la puerta, es posible que veas:

- **Solo botón de apertura**: Un botón de ancho completo para puertas que solo admiten la apertura
- **Botones de cierre y apertura**: Dos botones separados que te permiten cerrar o abrir la puerta (para puertas con capacidad de cierre, como cerraduras motorizadas)

![Lista de llaves en la aplicación Nebula Keychain](images/key-list.png "Algunas puertas pueden tener botones de cierre y apertura si admiten ambas acciones")
{.border}

Para las puertas compatibles, el estado se actualiza automáticamente según el estado actual de la puerta (**Cerrada** o **Abierta**).
Cuando tocas **Cerrar**, es posible que se te pida que confirmes la acción, y la aplicación mostrará información similar a la de apertura (**Cerrando...**, y luego **Puerta cerrada** o un mensaje si el cierre ha fallado).

### Cuando no tienes acceso {#no-access}

Si no tienes ninguna llave digital activa asignada, verás:

- Un icono de marcador de posición
- El mensaje «Aún no hay acceso»
- Instrucciones para ponerte en contacto con tu emisor de llaves

![Mensaje de sin acceso en la aplicación Nebula Keychain](images/no-access.png "Si no tienes ninguna llave digital activa, la aplicación te pedirá que te pongas en contacto con tu emisor de llaves")
{.border}

## Cómo realizar aperturas con la aplicación Nebula Keychain {#unlocking-with-the-nebula-keychain-app}

Para abrir una puerta utilizando la aplicación Nebula Keychain:

1. **Abre la aplicación** y asegúrate de que el Bluetooth esté activado en tu dispositivo.
2. **Permite que la aplicación busque** puertas cercanas. Esto ocurre automáticamente cuando abres la pantalla **Mis llaves**.
3. **Asegúrate de que la puerta esté en el rango**. Cuando estás dentro del rango de Bluetooth (normalmente de 5 a 10 metros), las puertas se marcan como **Cercana**.
4. **Selecciona tu puerta** y **toca el botón de apertura**.
5. **Acércate más si es necesario**. Si aparece el mensaje «Acércate más a la puerta», debes estar más cerca (normalmente entre 2 y 3 metros).
   También puedes tocar físicamente el lector de la cerradura con tu teléfono si es necesario.

![Proceso de apertura en la aplicación Nebula Keychain](images/access-granted.png "El proceso de apertura en la aplicación Nebula Keychain proporciona información en tiempo real sobre el estado de la conexión y los permisos de acceso")
{.border}

### Lo que verás durante la apertura {#unlocking-feedback}

Cuando tocas el botón de apertura, la aplicación proporciona información visual:

1. **«Buscando dispositivo»** - La aplicación se está conectando a la cerradura Bluetooth de la puerta
2. **«Acércate más a la puerta»** - Estás demasiado lejos (aparece si la conexión no se establece en un plazo de 3 segundos)
3. **«Comprobando accesos»** - La aplicación está verificando tus permisos
4. **Mensaje de éxito o fallo** - Confirmación de que la puerta se ha abierto (o cerrado), o un mensaje de error como «Error de apertura» o «Error de cierre» si ha fallado

Todo el proceso suele durar entre 1 y 4 segundos cuando te encuentras en el rango adecuado.

## Cómo realizar aperturas con NFC {#unlocking-with-nfc}

<!-- TODO: check if NFC is only for Android if not using batteryless locks. If so, add a note about this. -->

Si tu dispositivo tiene capacidad NFC, puedes abrir puertas sin abrir la aplicación Nebula Keychain:

1. **Asegúrate de que tu teléfono esté desbloqueado** (pantalla encendida y superada la pantalla de bloqueo)
2. **Mantén tu teléfono cerca del lector de la puerta** (a una distancia de entre 5 y 10 centímetros)
3. **Espera a que la puerta se abra** - El sistema NFC intentará abrirla automáticamente si tienes los permisos necesarios

**Requisitos para la apertura con NFC:**

- Un dispositivo con hardware NFC
- NFC activado en la configuración de tu dispositivo (solo en Android; el NFC está siempre activado en iOS)
- La aplicación Nebula Keychain instalada (la aplicación no necesita estar abierta)
- Tu teléfono debe estar desbloqueado
- Llave digital activa con permisos de acceso para esa puerta

{{% info-panel %}}
La apertura con NFC solo funciona con lectores de puertas compatibles que admiten tecnología NFC.
Es posible que no todas las puertas de tu instalación tengan esta capacidad.
Si la apertura con NFC no funciona, utiliza el [método de apertura por Bluetooth estándar a través de la aplicación](/nebula/user-guide/keyholder/unlocking#unlocking-with-the-nebula-keychain-app).
{{% /info-panel %}}

## Requisitos para la apertura basada en aplicaciones {#requirements}

Para que la aplicación pueda abrir puertas, necesitas:

- **Bluetooth activado** en tu teléfono inteligente
- **Servicios de ubicación activados** (requeridos por tu dispositivo para el escaneo Bluetooth)
- **Permiso de ubicación concedido** a la aplicación Nebula Keychain (solo en Android)
- **Proximidad física** a la puerta (dentro del rango de Bluetooth)

Si falta algún requisito, la aplicación muestra un mensaje específico pidiéndote que lo habilites, como **El Bluetooth está desactivado** o **Se requiere acceso a la ubicación**.

{{% info-panel %}}
La aplicación no necesita conexión a internet para abrir una puerta, pero necesita una periódicamente para sincronizar tus permisos de acceso.
{{% /info-panel %}}

## Cómo realizar aperturas con teclados {#unlocking-with-keypads}

Algunas instalaciones pueden tener teclados en los que puedes introducir un código para abrir la puerta.
Para utilizar un teclado, introduce el [código de acceso proporcionado por tu emisor de llaves](/nebula/user-guide/system-manager/users/assign-keys#passcodes).

## Solución de problemas de apertura {#troubleshooting-unlocking-issues}

Consulta la sección dedicada a la [solución de problemas comunes en la aplicación Nebula Keychain](/nebula/user-guide/keyholder/troubleshooting) para obtener consejos sobre cómo resolver los problemas que puedas encontrar, incluidos:

- Problemas de conexión Bluetooth
- Aparición de mensajes de «Acércate más»
- Puertas que no aparecen en la aplicación
- Problemas relacionados con los permisos
- NFC que no funciona

<!-- TODO: add when available
## Batteryless locks {#batteryless-locks}

See the dedicated section on [unlocking batteryless locks with the Nebula Keychain app](/nebula/user-guide/keyholder/batteryless-unlocking) for instructions on how to unlock doors that use batteryless electronic locks.
-->

## Referencia rápida: Escenarios de acceso a puertas {#quick-reference}

La siguiente tabla resume los diferentes escenarios que puedes encontrar al utilizar la aplicación Nebula Keychain para abrir puertas:

| Escenario                                     | Lo que ves                            | Qué significa                                                                                 | Acción requerida                                          |
| --------------------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| **Acceso único**                              | Una tarjeta con botón de apertura     | Tienes un acceso único; esto puede ser una puerta o varias puertas que se abren conjuntamente | Toca abrir cuando estés dentro del rango                  |
| **De 2 a 5 puertas**                          | Lista desplazable de puertas          | Tienes acceso a varias puertas                                                                | Selecciona una puerta y luego toca abrir                  |
| **Más de 5 puertas**                          | Lista con barra de búsqueda           | Tienes acceso a varias puertas                                                                | Utiliza la búsqueda para encontrar tu puerta              |
| **Puerta marcada como «Cercana»**             | Se muestra el icono de Bluetooth      | La puerta está dentro del rango de Bluetooth (5-10 m)                      | Listo para abrir                                          |
| **Puerta marcada como «Fuera de rango»**      | Icono de Bluetooth en gris            | La puerta está demasiado lejos                                                                | Acércate (a menos de 5-10 m)           |
| **«Buscando dispositivo»**                    | Indicador de carga                    | La aplicación se está conectando a la cerradura de la puerta                                  | Espera (normalmente de 2 a 3 segundos) |
| **«Acércate más a la puerta»**                | Mensaje de advertencia                | No se puede establecer la conexión                                                            | Acércate a una distancia de entre 2 y 3 metros            |
| **«Comprobando accesos»**                     | Indicador de carga                    | La aplicación está verificando tus permisos                                                   | Espera a que se confirme                                  |
| **«Acceso concedido»**                        | Mensaje de éxito                      | La puerta se ha abierto                                                                       | La puerta está ahora abierta                              |
| **Botones de cierre y apertura**              | Botón dividido con control deslizante | La puerta admite tanto el cierre como la apertura                                             | Pulsa la acción deseada                                   |
| **Solo botón de apertura**                    | Botón de apertura de ancho completo   | La puerta solo admite la apertura                                                             | Toca para abrir                                           |
| **«Aún no hay llaves» / «Aún no hay acceso»** | Marcador de posición con mensaje      | No se han asignado permisos de acceso                                                         | Ponte en contacto con el emisor de llaves                 |
| **Se muestran hasta 15 puertas**              | Tamaño máximo de la lista             | Varias ubicaciones asignadas                                                                  | Solo se muestran las puertas cercanas                     |

### Resumen de los métodos de apertura {#unlocking-methods}

| Método                                        | Dispositivo           | Requisitos                                               | Cuándo utilizar                                                     |
| --------------------------------------------- | --------------------- | -------------------------------------------------------- | ------------------------------------------------------------------- |
| **Bluetooth (aplicación)** | iOS y Android         | Aplicación abierta, Bluetooth activado, dentro del rango | Método estándar, mayor control                                      |
| **Tocar con NFC**                             | iOS y Android         | Teléfono desbloqueado, NFC activado, lector compatible   | Acceso rápido sin abrir la aplicación                               |
| **Teclado**                                   | Cualquier dispositivo | Código de acceso del emisor de llaves                    | Cuando el teléfono no esté disponible o se necesite una alternativa |
| **Llave física**                              | No aplicable          | Tarjeta o llavero asignados                              | Alternativa al acceso digital                                       |

**Consejo:** Utiliza el botón de actualizar en la parte superior de la pantalla **Mis llaves** si no ves las puertas esperadas o los permisos de acceso recién asignados.

