Skip to content

Diseñar, validar y activar un intercambio

Construye un intercambio criptográfico: quién envía y quién recibe, el contexto en el que opera y las concesiones que indican qué identidades pueden hacer qué, con qué claves. Después valídalo y activa todas las concesiones a la vez.

Quién puede hacerlo

Un administrador del tenant, un gestor de claves del tenant, o un superadministrador de plataforma desde dentro del tenant, donde la consola actúa como administrador del tenant. La consola ofrece Nuevo intercambio solo a una persona que tiene el permiso para crear intercambios; guardar el borrador, validar, activar y descartar requieren cada uno su propio permiso sobre los intercambios.

Agregar concesiones al intercambio también requiere el permiso para crear concesiones de capacidad. La activación agrega permisos de operación al actor de cada concesión, así que la persona que activa también debe poder asignar roles a los actores.

La pantalla es para los tenants STANDARD: un tenant SIMPLE no la ve, y en un tenant RAPIDAPI la plataforma crea los intercambios.

Antes de empezar

  • Al menos un extremo del intercambio es una de tus aplicaciones. El otro extremo es otra de tus aplicaciones o una contraparte externa, que puedes clasificar con un tipo de contraparte.
  • Existe un contexto de intercambio para el intercambio, o creas uno desde el editor.
  • La aplicación de cada extremo tiene un actor criptográfico, y existen las claves que nombrarán las concesiones. Una concesión solo se puede dar a un actor de una aplicación de uno de los dos extremos.

Pasos

  1. Abre Intercambios criptográficos y selecciona Nuevo intercambio. El editor recorre cinco pasos; Guardar conserva tu trabajo y Guardar y continuar → pasa al paso siguiente.
  2. Descripción general: escribe el Nombre (obligatorio) y un Propósito de negocio. De forma opcional, establece la ventana de validez, cuyos campos indican la zona horaria en que se leen.
  3. Extremos: para el Origen y el Destino, elige Una de tus aplicaciones y selecciónala, o Contraparte externa y escribe el nombre y el tipo de la contraparte. La consola muestra la Relación: resultante: entrante, interna, saliente o misma aplicación.
  4. Contexto de intercambio: selecciona el contexto. Selecciona Nuevo contexto de intercambio para crear uno sin salir del editor. El borrador se guarda por primera vez cuando se eligen los dos extremos y un contexto.

  5. Concesiones: selecciona Agregar concesión, elige el Actor criptográfico, elige Qué autoriza la concesión y luego:

    • para Operaciones sobre una clave, marca las Operaciones y elige la Clave;
    • para Volver a cifrar o a firmar, elige la Operación y uno o más Pares de claves (origen → destino).

    De forma opcional, elige una Política de restricciones (opcional) y luego selecciona Agregar concesión. Repite para cada identidad que necesite autoridad.

  6. Revisar y activar: lee el resumen y luego selecciona Validar (de DRAFT a READY). Cada infracción aparece con su campo.

  7. Cuando la validación pasa, selecciona Activar (todas las concesiones vigentes, en una sola escritura). La confirmación, ¿Activar este intercambio?, lista lo que la activación hará con cada concesión: sus operaciones, sus claves, su política de restricción y los permisos de operación que gana su actor. Selecciona Activar.

Un intercambio solo se puede cambiar mientras es un borrador o está listo. Para cambiar un intercambio activo, suspendido o terminado, selecciona Clonar: la copia se abre como un borrador nuevo. Para abandonar un intercambio en borrador o listo, selecciona Descartar borrador y luego Descartar.

Qué ves cuando funcionó

El editor muestra La validación pasó: este intercambio está READY. después de la validación, y después de la activación El intercambio está ACTIVE con <n> concesiones. El estado junto al nombre del intercambio dice Activo, y la revisión indica, para cada concesión, si su identidad puede llamar al intercambio. Cada paso del editor lleva una ✓ cuando está completo.

El intercambio aparece en Intercambios criptográficos y en la topología de intercambios. Su actividad, en la columna lateral, registra cada cambio.

Si falla

Qué ves Causa Qué hacer
Elige los dos extremos y un contexto para guardar este borrador. Un borrador nuevo se guarda solo cuando se eligen los dos extremos y un contexto Completa Extremos y Contexto de intercambio
Al menos un extremo debe ser una de tus aplicaciones. Los dos extremos son contrapartes externas Haz que un extremo sea una de tus aplicaciones
Este intercambio está en estado <status>, así que ya no se puede editar: solo se pueden editar los intercambios DRAFT o READY. Clónalo para editar una copia. El intercambio está activo, suspendido o terminado Selecciona Clonar para editar y cambia la copia
Este intercambio no tiene ninguna concesión vigente, así que activarlo no autorizaría nada. Agrega una concesión primero. El intercambio no tiene ninguna concesión vigente Agrega una concesión, valida de nuevo y luego activa
El contexto de intercambio está <status>, no activo, así que no acepta concesiones ni activaciones nuevas. El contexto está suspendido o cerrado Reactiva el contexto, o mueve el borrador a otro contexto
El actor que este intercambio autorizaría está en estado <status>, no ACTIVE, así que no se le puede conceder nada. Reactiva el actor antes de activar. El actor de una concesión no está activo Reactiva el actor
Activar este intercambio añadiría permisos de operación a su actor, y tu cuenta no puede concederlos. Debe activarlo un administrador que pueda asignar roles a los actores. No puedes conceder los permisos que necesitan las concesiones Pide a un administrador que pueda asignar roles a los actores que lo active
Otra persona modificó este intercambio mientras esta página estaba abierta, así que no se aplicó nada. Revisa su estado actual e inténtalo de nuevo. Otro administrador cambió el intercambio Revisa el estado actual y repite la acción. Consulta Concurrent Modification (en inglés)

Sin la consola

Superficie Cómo
CLI de gestión de claves ankasecure-km exchanges create --body-file <file>; exchanges update --id <uuid> --body-file <file>; exchanges validate --id <uuid>; exchanges preview-activation --id <uuid>; exchanges activate --id <uuid>; exchanges clone --id <uuid>; exchanges discard-draft --id <uuid> --expected-version <n>
Admin SDK ExchangeOperations.create(ExchangeCreateRequest), update(UUID, ExchangeUpdateRequest), validate(UUID), previewActivation(UUID), activate(UUID, ActivateRequest), cloneExchange(UUID, CloneRequest), discardDraft(UUID, int)
API POST /api/v3/admin/exchanges (operación createExchange); PATCH /api/v3/admin/exchanges/{id} (operación updateExchange); POST /api/v3/admin/exchanges/{id}/validate (operación validateExchange); GET /api/v3/admin/exchanges/{id}/activation-preview (operación previewExchangeActivation); POST /api/v3/admin/exchanges/{id}/activate (operación activateExchange); POST /api/v3/admin/exchanges/{id}/clone (operación cloneExchange); DELETE /api/v3/admin/exchanges/{id} (operación discardDraft)

Las concesiones se agregan con una operación aparte; consulta Conceder o revocar el acceso de una parte a un intercambio.

Relacionado