Registrar una aplicación
Registra el sistema de negocio en cuyo nombre se hace el trabajo criptográfico, con su responsable y sus etiquetas de riesgo. La plataforma crea la aplicación junto con su actor criptográfico predeterminado, que es lo que después se autentica y llama a la plataforma.
Quién puede hacerlo
Un administrador del tenant o un gestor de claves del tenant, y un superadministrador de plataforma que trabaja en un tenant en un despliegue de nube privada o local. En un despliegue SaaS, un administrador de la plataforma no puede trabajar con los datos de otro tenant. La consola ofrece Nueva aplicación a quien tiene el permiso para crear aplicaciones; sin él, el control se muestra deshabilitado con el motivo. Editar aplicación, Suspender, Reactivar y Deshabilitar definitivamente se ofrecen a quien tiene el permiso para actualizar aplicaciones.
Antes de empezar
- Elige un nombre que ninguna aplicación vigente de tu tenant use ya. Los nombres se comparan sin distinguir mayúsculas de minúsculas en las letras de la A a la Z.
- Un tenant RAPIDAPI no crea aplicaciones: las crea la plataforma, y la consola no muestra el control.
Pasos
- Abre Aplicaciones desde la navegación del tenant.
- Selecciona Nueva aplicación. Se abre el asistente Crear aplicación.
- En Identidad, escribe el Nombre de la aplicación (obligatorio) y, de forma opcional, un Nombre visible y una Descripción. Selecciona Siguiente.
- En Información de negocio, establece de forma opcional el Entorno, la Unidad de negocio, el Centro de costos, el Nombre del responsable, el Correo del responsable, el Nombre del contacto técnico y el Correo del contacto técnico. Selecciona Siguiente.
- En Riesgo y cumplimiento, establece de forma opcional la Clasificación de datos, el Nivel de riesgo y el Alcance regulatorio; selecciona Agregar para cada regulación. Selecciona Siguiente.
- Revisa el resumen y luego selecciona Crear aplicación.
Los valores de negocio y de riesgo son etiquetas. Se muestran en la aplicación y en los informes, y ninguno cambia lo que la aplicación tiene permitido hacer.
Para cambiar una aplicación más adelante, ábrela desde Aplicaciones; los controles están al pie de su panel:
- Selecciona Editar aplicación, cambia los nombres o la información de negocio y selecciona Guardar cambios. Solo se envían los campos que cambias. Un campo vaciado conserva su valor actual: un campo de la aplicación no se puede borrar.
- Para detener una aplicación activa, selecciona Suspender y luego Suspender aplicación. Sus actores no pueden autenticarse hasta que se reactive, y sus solicitudes de aprobación pendientes se cancelan; sus claves, sus actores y sus intercambios se conservan.
- Para que una aplicación suspendida vuelva a funcionar, selecciona Reactivar y luego Reactivar aplicación. Sus actores vuelven a autenticarse con sus propias credenciales.
- Para detener de forma definitiva una aplicación activa o suspendida, selecciona Deshabilitar definitivamente. Escribe el nombre de la aplicación para confirmar y vuelve a seleccionar Deshabilitar definitivamente; no se pide ningún motivo. Sus actores ya no pueden autenticarse y sus solicitudes de aprobación pendientes se cancelan.
Deshabilitar es definitivo: una aplicación deshabilitada nunca se puede reactivar, así que la consola no ofrece ninguna acción de estado sobre ella. Su registro se conserva, y sus nombres y su información de negocio todavía se pueden editar. Para detener una aplicación durante un tiempo, suspéndela. Registra una aplicación nueva si el sistema todavía se necesita después de deshabilitarla.
Qué ves cuando funcionó
El asistente muestra Aplicación creada e indica que se creó un actor criptográfico predeterminado con la aplicación. Selecciona Abrir el actor predeterminado para generar credenciales para ir a ese actor, o Cerrar.
La aplicación aparece en Aplicaciones como activa, y los totales sobre la lista se vuelven a leer. Un cambio de estado muestra Aplicación suspendida, Aplicación reactivada o Aplicación deshabilitada, y el panel muestra el estado nuevo. Su actor predeterminado todavía no tiene ninguna credencial: nada puede autenticarse como él hasta que se emita una credencial o se le vincule una identidad externa.
Si falla
| Qué ves | Causa | Qué hacer |
|---|---|---|
| El asistente vuelve al primer paso con el nombre rechazado | Una aplicación vigente del tenant ya tiene ese nombre, sin distinguir mayúsculas de minúsculas | Elige otro nombre. Una aplicación eliminada no conserva su nombre. Consulta Application Name Conflict (en inglés) |
| Siguiente sigue deshabilitado en el primer paso | El nombre está vacío, o un nombre, un nombre visible o una descripción es demasiado largo | Escribe un nombre y acorta el campo que marca el contador |
| Un campo de correo muestra "Escribe una dirección de correo válida" | El correo del responsable o del contacto técnico no es una dirección | Corrígelo, o déjalo vacío |
| Se rechaza la creación para el tenant de la plataforma | No se pueden crear aplicaciones en el tenant de la plataforma | Crea la aplicación en un tenant normal |
| Un error se queda en el paso de revisión | El servicio rechazó la escritura o falló; no se creó nada | Inténtalo de nuevo. Si se repite, indica al operador de la plataforma el id de solicitud que se muestra |
| Se rechaza el campo de nombre de la edición | Otra aplicación vigente del tenant tiene ese nombre | Elige otro nombre. Consulta Application Name Conflict (en inglés) |
| No se actualizó la aplicación, con el motivo del servidor | El cambio se rechazó o falló; no se cambió nada | Corrige lo que indica el motivo, o inténtalo de nuevo |
| No se cambió el estado de la aplicación, con el motivo del servidor | La suspensión, la reactivación o la deshabilitación se rechazó o falló; no se cambió nada | Corrige lo que indica el motivo, o inténtalo de nuevo |
| Se rechaza el cambio de estado por ser un estado terminal | La aplicación está deshabilitada, lo que es definitivo; no se aplicó nada del cambio | Registra una aplicación nueva. Consulta Terminal application state (en inglés) |
| Una edición muestra No se actualizó la aplicación sobre Guardar cambios, rechazada por una modificación concurrente; un cambio de estado lo muestra bajo No se cambió el estado de la aplicación | Otra escritura (una edición, un cambio de estado, una eliminación, un cierre del tenant) cambió la aplicación después de leerla; no se aplicó nada | Vuelve a abrir la aplicación e inténtalo de nuevo. Consulta Concurrent Modification (en inglés) |
| No se pudo leer la aplicación para editarla | El registro actual no se pudo leer antes de abrir la edición | Cierra el panel, vuelve a abrir la aplicación e inténtalo de nuevo |
Sin la consola
| Superficie | Cómo |
|---|---|
| API | POST /api/v3/admin/tenants/{tenantId}/applications (operación createApplication); un nombre que tiene otra aplicación vigente se rechaza con 409 application-name-conflict |
| API | PATCH /api/v3/admin/tenants/{tenantId}/applications/{applicationId} (operación updateApplication): cambia los nombres, las etiquetas o el estado de una aplicación; Editar aplicación, Suspender, Reactivar y Deshabilitar definitivamente de la consola la llaman. Establecer status en DISABLED la deshabilita de forma definitiva: un cambio posterior a ACTIVE o SUSPENDED se rechaza con 409 terminal-application-state y no aplica nada, mientras que un cambio que mantiene DISABLED u omite status sigue editando los demás campos. Un nombre nuevo que tiene otra aplicación vigente se rechaza con 409 application-name-conflict, y una escritura que perdió la carrera con otra, con 409 concurrent-modification |
Relacionado
- Aplicaciones: qué muestra la pantalla y cada decisión que tomas en ella.