Playground criptográfico

Para qué sirve esta pantalla

El Playground demuestra, con una sola acción, que un flujo que tu tenant configuró funciona en Runtime, el servicio criptográfico de la plataforma. Un flujo es todo lo que un intercambio o un caso de uso interno configura sobre una clave: cifrar y descifrar, firmar y verificar, y recifrar o refirmar desde esa clave.

Cada ejecución es una operación real en Runtime, ejecutada como el Actor que nombra la configuración. Es la petición que enviaría tu aplicación, así que ves la misma respuesta: el ID de clave, la versión del material y el algoritmo que Runtime usó realmente. La pantalla no crea ni cambia ninguna clave, credencial, intercambio, caso de uso interno ni autorización. Para ver la agilidad criptográfica en acción, ejecuta un flujo, rota su clave en la pantalla de claves, vuelve y compara las dos ejecuciones.

Qué debe existir antes

Un tenant STANDARD o SIMPLE. Esta pantalla no se ofrece a los tenants RAPIDAPI.
El rol de administrador del tenant o el de gestor de claves. Los dos llevan el permiso del Playground, y solo ellos: un rol personalizado no puede incluirlo.
Un intercambio o un caso de uso interno con operaciones sobre una clave. Un tenant SIMPLE trabaja solo con casos de uso internos.
Como máximo 10.000 autorizaciones legibles en los intercambios y casos de uso internos del tenant, el máximo que lista el Playground. Por encima, la lista no carga hasta que se revocan las que ya no se usan.

No necesitas ningún token ni ninguna credencial del Actor. El Playground nunca crea, recupera ni revela una credencial. Puedes llegar aquí desde un intercambio, un caso de uso interno, una clave o la tarjeta de primeros pasos. Un enlace abre la lista ya filtrada por ese elemento y no concede nada.

Decisiones que tomas aquí

Encontrar un flujo

Cada tarjeta es un intercambio o un caso de uso interno, con una sección por clave. Nombra a las partes con palabras, por ejemplo IDEMIA envía a card-issuance o Dentro de fraud-prevention, y cada sección ofrece una acción por paso, con la operación y el Actor que la ejecuta, por ejemplo Descifrar como card-issuance-decryptor, y en un recifrado o un refirmado también la clave a la que pasa: Recifrar como key-rotator → my-key-2.

Ejecutar ida y vuelta aparece cuando el flujo puede producir y consumir sobre esa clave, y Probar la migración (recifrado) o Probar la migración (refirmado) junto a cada recifrado o refirmado que puedes ejecutar cuando el flujo también puede cifrar o firmar con su clave de origen. Cuando la clave de destino es la sección siguiente, la prueba de migración aparece entre las dos. Una sección en la que no puedes ejecutar nada muestra solo sus motivos.

La búsqueda encuentra una clave, una configuración, una aplicación, una contraparte o el nombre de un Actor, y basta con una parte del nombre: my-key también muestra my-key-2. Una tarjeta listada conserva todas sus claves, y cada sección nombra su clave exacta, así que elige la que buscas.

Los intercambios y casos de uso en los que no puedes ejecutar nada ahora quedan tras Mostrar los intercambios y casos de uso que no se pueden ejecutar (en un tenant SIMPLE, Mostrar los casos de uso que no se pueden ejecutar), que indica entre paréntesis cuántos son, cada uno con su motivo en una frase. Una concesión de capacidad comodín no pertenece a ninguna configuración, así que no aparece aquí. Para probarla, usa el SDK o la CLI con la credencial del propio Actor.

Ejecutar una operación

Una operación abre un panel lateral con la operación, el Actor con el que se ejecuta y la clave. El panel indica que la ejecución se hace bajo tu delegación, solo para esa ejecución.

Cifrar y firmar se abren con un texto de ejemplo que puedes cambiar. Descifrar, verificar, recifrar y refirmar necesitan un artefacto. Cuando el flujo puede cifrar o firmar con la clave que lee la operación, una acción como Cifrar como card-issuance-encryptor ejecuta esa operación sobre el texto de ejemplo, como el Actor de ese paso, que puede ser otro Actor distinto del de tu operación, y coloca su salida como entrada. Si no, solo se ofrece Pegar el mío, para un artefacto que ya tengas. Sin entrada, el botón de ejecución, por ejemplo Ejecutar Descifrar, queda desactivado e indica el motivo.

Esta pantalla admite solo texto: no tiene carga de archivos ni streaming. Cuando cifras o firmas por separado, un contador muestra los bytes de tu texto frente al límite. La ida y vuelta y la prueba de migración no muestran contador: un texto que supera el límite se rechaza con una frase y no se envía nada. Un artefacto queda sujeto al límite de tamaño de la petición completa.

Una operación con usos limitados te pide confirmar antes, porque cada ejecución gasta un uso. Cada persona tiene un límite de peticiones de ejecución por minuto. Cuenta cada petición, también una que se rechaza después, por ejemplo porque la configuración cambió. Cuando lo alcances, espera el tiempo que indica el mensaje.

Ejecutar la ida y vuelta

Ejecutar ida y vuelta cifra y después descifra, o firma y después verifica, el mismo texto, en dos ejecuciones. Termina con un único veredicto: El flujo funciona: el texto volvió sin cambios., El flujo funciona: la firma se verificó., El texto que volvió no es el texto que entró., La firma no se verificó., o un paso fallido, por ejemplo Falló el paso 2: Descifrar como card-issuance-decryptor., con el motivo de ese paso debajo. Cada paso conserva su propio ID de correlación, su entrada del historial y su intercambio HTTP, y la ida y vuelta cuenta como dos ejecuciones en tu límite.

Probar una migración

Probar la migración (recifrado) y Probar la migración (refirmado) demuestran que un recifrado o un refirmado deja el contenido utilizable con la clave de destino. El contenido pasa entre dos claves que ya existen y no se crea ninguna versión de clave. La prueba ejecuta hasta tres pasos sobre el mismo texto, cada uno como su propio Actor: cifrar con la clave de origen, recifrar con la clave de destino y descifrar con la clave de destino; o firmar, refirmar y verificar con la clave de destino.

El tercer paso se busca entre los flujos de la clave de destino. Cuando la clave de destino no tiene un descifrado o una verificación que puedas ejecutar, el panel lo indica antes de empezar, y la prueba ejecuta solo los dos primeros pasos. Cuando demasiados flujos coinciden con la clave de destino para encontrarlo, la prueba no se puede ejecutar: acota los nombres de las claves o ejecuta cada paso por separado. Una prueba de migración son dos o tres ejecuciones. Cada una conserva su propio ID de correlación, su entrada del historial y su intercambio HTTP, y cada una cuenta en tu límite.

Claves, antes y después muestra la clave, la versión y el algoritmo que usó cada paso. El veredicto es El texto volvió sin cambios, ahora protegido por my-key-2. o La firma se verificó con my-key-2.; La migración se ejecutó. No hay ningún paso de Descifrar configurado con my-key-2, así que el resultado no se abrió. Eso no es un fallo de la migración.; o un paso fallido, por ejemplo Falló el paso 2: Recifrar como key-rotator., con el motivo de ese paso debajo.

Ejecutar como un Actor

Nunca manejas el token del Actor. Para cada ejecución, la plataforma emite un token para ese Actor, válido como máximo 60 segundos, y lo usa para esa única petición. Nunca llega a tu navegador y nunca se muestra. Los dos roles que tienen este permiso, el administrador del tenant y el gestor de claves, pueden ejecutar operaciones como cualquier Actor del tenant. Ya tienen esa autoridad, porque pueden crear y rotar la credencial de un Actor. El Playground lo registra: cada ejecución te nombra como administrador junto al Actor con el que se ejecutó.

En una sesión de acceso de soporte solo llega a esta pantalla un superadministrador de la plataforma, como administrador del tenant. En nube privada u on-premises puedes ejecutar: cada ejecución queda registrada a tu nombre, junto al Actor con el que se ejecutó y el inicio de sesión desde el que abriste el acceso de soporte. En un despliegue que opera ANKATech ves los flujos, pero no puedes ejecutar: lo hace un administrador o un gestor de claves del tenant. Una sesión de soporte con otro rol de plataforma no llega a la pantalla, y un acceso de emergencia nunca ejecuta una operación.

Leer el resultado

El resultado muestra primero el desenlace con palabras y después el ID de clave, la versión, el algoritmo y el estado de Runtime. Un valor que Runtime no informó aparece como No informado: nunca se completa con la configuración. El contenido descifrado se muestra como texto plano y nunca se ejecuta. Un valor largo se corta en pantalla: Copiar el valor completo lo copia entero.

Operación no autorizada: Runtime rechazó la ejecución. Una operación configurada no anula su decisión.
Actualiza el flujo; no se ejecutó nada y … no está activo, así que no se ejecutó nada: la configuración cambió después de que la leíste, o el Actor que ejecuta la operación está suspendido o desactivado. Un intercambio o un caso de uso interno suspendido muestra Actualiza el flujo; no se ejecutó nada.
No ejecutada: nunca se llegó a Runtime, o el servicio de autenticación falló o no se pudo alcanzar. Es seguro volver a ejecutarla.
No ejecutada: demasiadas ejecuciones y No ejecutada desde esta sesión: no se ejecutó nada. Se delegaron demasiadas ejecuciones en poco tiempo, así que espera un momento; o la sesión no puede ejecutarla: el acceso de soporte solo ejecuta en despliegues de nube privada y on-premises, y un inicio de sesión de acceso de emergencia nunca ejecuta una operación.
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, así que si vuelves a ejecutarla se rechazará de la misma forma. Tu sesión de la consola no se ve afectada.
Estado de ejecución desconocido: la ejecución pudo ocurrir y no llegó respuesta. Rastrea su ID de correlación antes de ejecutarla de nuevo. Nada se reintenta por ti.

Un fallo de Runtime después de admitir la ejecución avisa de que pudo gastarse un uso. En un tenant SIMPLE, Operación no autorizada aparece sin el motivo de Runtime. En Intercambio HTTP, la pestaña Respuesta sustituye por un aviso el cuerpo de cualquier respuesta fuera de 2xx, porque el texto de Runtime puede nombrar objetos que este tipo de tenant no utiliza. El estado, el ID de correlación y la pestaña Solicitud se conservan, así que la ejecución se puede rastrear.

Herramientas para desarrolladores

Intercambio HTTP y Copiar como cURL están plegados bajo el resultado. Muestran la petición enviada a Runtime y su respuesta, saneadas: el token aparece como $ACTOR_TOKEN. El texto cURL lleva $RUNTIME_URL y $ACTOR_TOKEN para que los completes con un token que tu aplicación obtiene con la credencial del propio Actor.

Historial de ejecuciones, junto a los filtros, abre las ejecuciones en un panel lateral con Comparar ejecuciones: dos ejecuciones lado a lado, con el Estado de cada una. Por defecto, una ejecución se compara con la última ejecución anterior de la misma operación con la misma clave, que es la comparación que muestra qué hizo un cambio como la rotación de la clave. Si no hay ninguna, el panel lo indica en lugar de comparar ejecuciones sin relación, y aún puedes elegir otra ejecución.

El panel lista todas las ejecuciones del historial, con la que se compara marcada como Última ejecución (o Esta ejecución cuando lo abriste sobre una ejecución anterior), y solo se pueden elegir ejecuciones anteriores. Cambió marca un dato que difiere y solo se aplica a los datos que ambas ejecuciones informaron. Un resultado ofrece Comparar con la ejecución anterior cuando existe esa ejecución anterior. El historial guarda las últimas 20 ejecuciones solo como metadatos, nunca su contenido, y termina al cerrar sesión, al cambiar de tenant y al recargar.

Rastrear una ejecución

Cada ejecución tiene su propio ID de correlación. Une tu registro, que te nombra a ti, la operación y el Actor, con el registro que Runtime guarda de la operación, que nombra al Actor y a ti como el administrador que delegó. La traza de auditoría los muestra juntos como ejecutado por ti como el Actor. Si una aplicación que llama directamente a Runtime reutiliza ese ID de correlación, coincide más de un registro de Runtime. La traza muestra entonces la coincidencia como ambigua en lugar de adivinar.

Cómo se relaciona con otras pantallas

Las configuraciones son las que gestionas en las pantallas de intercambios y de casos de uso internos, y las correcciones se hacen allí. La rotación sigue en la pantalla de claves, y la traza de auditoría muestra cada ejecución: