Probar una operación en el Playground criptográfico
Comprueba que un flujo que configuró tu tenant funciona en Runtime: ejecuta una operación como el Actor que nombra la configuración, ejecuta una ida y vuelta sobre el mismo texto, o prueba una migración entre dos claves.
Quién puede hacerlo
El administrador del tenant o el gestor de claves. Solo esos dos roles llevan el permiso del Playground: un rol personalizado no puede incluirlo.
Nunca manejas el token ni la credencial del Actor. Para cada ejecución la plataforma emite un token para ese Actor, válido como máximo 60 segundos, y cada ejecución te nombra como el administrador que la delegó.
En una sesión de acceso de soporte, un superadministrador de la plataforma ejecuta los flujos en un despliegue de nube privada u on-premises, y cada ejecución queda registrada a su nombre; en un despliegue que opera ANKATech se listan los flujos y cada ejecución se rechaza. Una sesión de acceso de emergencia nunca ejecuta una operación.
Antes de empezar
- Un tenant STANDARD o SIMPLE.
- Un intercambio o un caso de uso interno con operaciones sobre una clave. Un tenant SIMPLE trabaja solo con casos de uso internos. Una concesión de capacidad comodín no pertenece a ninguna configuración y no aparece: pruébala con el SDK o la CLI y la credencial propia de ese Actor.
- El Actor que ejecuta la operación está activo.
- Una operación con usos limitados pide confirmación, porque una ejecución gasta un uso. Cada persona tiene un límite de solicitudes de ejecución por minuto.
Pasos
- Abre Playground criptográfico desde la navegación del tenant. Cada tarjeta es un intercambio o un caso de uso interno y nombra a las partes en palabras. Tiene una sección por clave, y cada sección ofrece una acción por paso, con el nombre de la operación y del Actor, por ejemplo "Descifrar como card-issuance-decryptor". Busca por clave, configuración, aplicación, contraparte o nombre de Actor; una tarjeta encontrada conserva todas sus claves.
- Para ejecutar una operación, selecciona su acción. Un panel lateral muestra la operación, el Actor y la clave.
- Cifrar y firmar se abren con un texto de ejemplo que puedes cambiar.
- Descifrar, verificar, recifrar y refirmar necesitan un artefacto: selecciona la acción productora que ofrece el panel (por ejemplo "Cifrar como card-issuance-encryptor"), que coloca su salida como entrada, o selecciona Pegar el mío.
- Selecciona el botón de ejecución, que nombra la operación (por ejemplo "Ejecutar Descifrar").
- Para comprobar el flujo completo, selecciona Ejecutar ida y vuelta en la sección de la clave. Cifra y descifra, o firma y verifica, el mismo texto en dos ejecuciones, con los pasos de ese intercambio o caso de uso interno.
- Para comprobar una migración, selecciona Probar la migración (recifrado) o Probar la migración (refirmado) junto al recifrado o la refirma, o entre las secciones de la clave de origen y de destino cuando la de destino va a continuación. Ejecuta hasta tres pasos sobre el mismo texto, cada uno como su propio Actor: cifrar con la clave de origen, recifrar a la clave de destino y descifrar con la clave de destino (o firmar, refirmar y verificar). No se crea ninguna versión de clave.
- Para comparar ejecuciones, por ejemplo antes y después de rotar la clave en la pantalla de claves, abre Historial de ejecuciones junto a los filtros, o selecciona Comparar con la ejecución anterior en un resultado.
Los intercambios y casos de uso en los que no puedes ejecutar nada ahora solo aparecen cuando eliges mostrar los que no se pueden ejecutar, cada uno con su motivo.
Qué ves cuando funcionó
El resultado muestra primero el desenlace en palabras, y luego el ID de clave, la versión, el algoritmo y el estado de Runtime. Un valor que Runtime no informó dice No informado.
- Una ida y vuelta termina con "El flujo funciona: el texto volvió sin cambios." o "El flujo funciona: la firma se verificó."
- Una prueba de migración muestra Claves, antes y después y termina con "El texto volvió sin cambios, ahora protegido por" la clave de destino, o "La firma se verificó con" ella. Cuando la clave de destino no tiene un descifrado o una verificación que puedas ejecutar, ejecuta dos pasos y dice "La migración se ejecutó. … Eso no es un fallo de la migración."
Intercambio HTTP y Copiar como cURL aparecen plegados bajo el resultado; el token aparece como $ACTOR_TOKEN. Cada ejecución tiene su propio identificador de correlación y aparece en la traza de auditoría como ejecutada por ti como el Actor.
Si falla
| Qué ves | Causa | Qué hacer |
|---|---|---|
| Operación no autorizada | Runtime rechazó la ejecución; una operación configurada no anula esa decisión | Revisa la concesión, el estado de la clave y la política de la configuración |
| "Este paso ya no está configurado. Actualiza el flujo; no se ejecutó nada." | La configuración cambió después de leerla, o su intercambio o caso de uso interno está suspendido | Actualiza el flujo y vuelve a ejecutarlo |
| "… no está activo, así que no se ejecutó nada." | El Actor está suspendido o deshabilitado | Reactiva el Actor o usa otro flujo |
| No ejecutada | Nunca se llegó a Runtime, o no se pudo emitir un token | Vuelve a ejecutarlo; no se ejecutó nada |
| No disponible para esta sesión | Runtime no aceptó el acceso temporal de la ejecución, o tu sesión no puede ejecutar como un Actor | Tu sesión de consola no se ve afectada; ejecútalo desde una sesión normal |
| Estado de ejecución desconocido | La ejecución pudo haber ocurrido y no llegó respuesta | Rastrea su identificador de correlación antes de volver a ejecutarla; nada se reintenta por ti |
| "El texto que volvió no es el texto que entró." o "La firma no se verificó." | El flujo se ejecutó pero no funciona como está configurado | Revisa las claves y los algoritmos de los dos pasos |
| "Falló el paso 2: …" | Falló un paso de una ida y vuelta o de una prueba de migración | Lee el motivo debajo y corrige ese paso |
| El mensaje del límite por minuto | Alcanzaste tus solicitudes de ejecución por minuto | Espera el tiempo que indica el mensaje |
| La lista no carga y nombra un límite de 10.000 autorizaciones legibles | El tenant tiene más de 10.000 autorizaciones legibles en sus intercambios y casos de uso internos, el máximo que lista el Playground | Revoca las autorizaciones que el tenant ya no usa; consulta Crypto Playground Catalog Too Large |
Sin la consola
El SDK, cli-crypto y la API ejecutan las mismas operaciones como el propio Actor, con la credencial propia del Actor: consulta Cifrar y descifrar datos.