Organización y claves
Los administradores de su organización gestionan sus claves desde la aplicación: crean una clave para cada dispositivo o persona, eligen su función, le cambian el nombre y la revocan. La primera clave de administrador se retira una sola vez con el código de retiro de la solicitud de acceso, cuando DeepLeaf Yield la aprueba. Consulte Obtener su clave e iniciar sesión.
Su organización
Una organización es una cuenta de cliente en DeepLeaf Yield. Contiene sus fincas, invernaderos, hileras, ciclos de cultivo, recorridos y registros. Cada clave pertenece exactamente a una organización.
Funciones
| Qué puede hacer la clave | Administrador | Miembro |
|---|---|---|
| Analizar recorridos, guardarlos en ciclos, consultar resultados y previsiones | Sí | Sí |
| Crear, editar y eliminar fincas, invernaderos, hileras, ciclos y registros | Sí | Sí |
| Ver la facturación: plan, estado, recorridos de este mes, facturas | Sí | Sí |
| Pagar con tarjeta, gestionar la tarjeta, pagar por transferencia bancaria, solicitar una factura para transferencia | Sí | No |
| Enumerar, crear, renombrar y revocar claves | Sí | No |
Una clave de miembro que intenta una acción de administrador recibe 403. Las claves emitidas antes de que existieran las funciones son claves de administrador, así que conservan el acceso completo.
Gestionar las claves en la aplicación
- Inicie sesión en la aplicación con una clave de administrador y abra Claves de acceso desde el menú de la cuenta (
/app/settings/keys). - La tabla muestra el nombre de cada clave, su función, cuándo se creó, cuándo se usó por última vez y si está revocada. El último uso se actualiza como mucho una vez por minuto.
- Elija Crear clave. En el cuadro de diálogo, dele un nombre como «Tableta» u «Oficina del invernadero», elija Miembro o Administrador y pulse Crear clave.
- La nueva clave aparece una sola vez, con un botón Copiar. Guárdela en un gestor de contraseñas y pulse Listo. DeepLeaf Yield solo conserva un hash de ella y no puede volver a mostrarla.
/app/settings/keys. Aquí nunca aparecen los valores de las claves, solo sus nombres y funciones.Para cambiar el nombre de una clave, elija el lápiz junto a su nombre y escriba uno nuevo. La clave en sí no cambia.
Revocar una clave
Elija Revocar en una clave que se haya perdido o compartido, o que pertenezca a alguien que ya no está. Deja de funcionar en la siguiente solicitud, en la aplicación y en los scripts, también en los navegadores que ya tenían la sesión iniciada con ella.
La organización siempre conserva una clave de administrador activa. Revocar la última se rechaza con un mensaje; cree antes otra clave de administrador. Si se pierden todas las claves de administrador, escriba a hello@deepleaf.io y DeepLeaf emitirá una nueva.
Quién puede ver qué
- Cada clave, de administrador o de miembro, solo lee y modifica los datos de su propia organización.
- Ninguna clave puede leer los datos ni las claves de otra organización. Las rutas de otra organización responden como no encontradas.
Desde un script
| Método y ruta | Qué hace |
|---|---|
GET /api/organizations/{org}/keys | Las claves de la organización, sin sus valores. |
POST /api/organizations/{org}/keys | Crea una clave (name, role). La respuesta contiene api_key, que se muestra una sola vez. |
PATCH /api/organizations/{org}/keys/{id} | Cambia el nombre de una clave (name). |
POST /api/organizations/{org}/keys/{id}/revoke | Revoca una clave. 409 para la última clave de administrador. |
Próximamente
El alta autónoma de nuevas organizaciones figura en la hoja de ruta. Los planes y el pago se explican en Facturación y planes.