Crear un contexto de intercambio
Crea el marco de negocio en el que operan los intercambios criptográficos con terceros: su propósito, qué tan sensibles son sus datos y, cuando aplica, su régimen regulatorio. Cada intercambio y cada concesión de capacidad pertenecen a exactamente un contexto. Esta página también explica cómo cambiar los datos de un contexto y cómo eliminar un contexto que ya se cerró.
Quién puede hacerlo
Un administrador del tenant o un gestor de claves del tenant. La consola ofrece Nuevo contexto de intercambio solo a una persona que tiene el permiso para crear contextos de intercambio. Cambiar un contexto requiere el permiso para actualizarlo, y eliminar un contexto cerrado requiere el permiso para eliminarlo; ambos roles tienen los tres.
La pantalla es para los tenants STANDARD. Un tenant SIMPLE no la ve y la plataforma se niega a crear un contexto allí: sus contextos los crean sus casos de uso internos. En un tenant RAPIDAPI la plataforma crea los contextos, y la consola no ofrece crear uno.
Antes de empezar
- Elige un nombre. Debe tener letras minúsculas, dígitos y guiones, y empezar y terminar con una letra o un dígito, por ejemplo
embossing-visa. Es único entre los contextos vigentes del tenant y no se puede cambiar después. - Decide qué tan sensibles son los datos que se intercambian en el contexto. La sensibilidad es una etiqueta para las personas que leen la consola; ningún algoritmo, política ni decisión de autorización la lee.
Pasos
- Abre Contextos de intercambio desde la navegación del tenant.
- Selecciona Nuevo contexto de intercambio.
- Completa el diálogo:
- El nombre (marcado como slug). Es obligatorio.
- Sensibilidad: Baja, Media, Alta o Crítica. El valor predeterminado es Media.
- Régimen regulatorio (opcional), por ejemplo
PCI DSS. Como máximo 120 caracteres. - Nombre visible (opcional): un nombre legible, por ejemplo
Card Embossing — VISA. - Propósito de negocio (opcional): por qué existen los intercambios de este contexto.
- Selecciona Crear.
Para cambiar un contexto más adelante, selecciona su fila, abre la pestaña Editar, cambia el nombre visible, la descripción, el propósito de negocio, la sensibilidad o el régimen regulatorio, y selecciona Guardar cambios. Vaciar el régimen regulatorio lo quita. El nombre nunca cambia.
Para eliminar un contexto, ciérralo primero (consulta la tarea relacionada). Luego selecciona su fila, abre la pestaña Ciclo de vida, selecciona Eliminar (permanente), escribe el nombre del contexto para confirmar y selecciona Eliminar.
Qué ves cuando funcionó
La consola muestra Contexto de intercambio "<name>" creado, y el contexto aparece en la lista como ACTIVO: está activo desde que se crea. Al seleccionar su fila se abre la pestaña Información, que muestra el identificador del contexto, sus campos y su Propietario, Este tenant.
Ahora el contexto se puede elegir en el paso Contexto de intercambio del editor de intercambios, y se pueden colocar concesiones de capacidad en él. Después de una edición, la consola muestra Contexto de intercambio actualizado; después de una eliminación, "<name>" eliminado, y el contexto sale de la lista.
Si falla
| Qué ves | Causa | Qué hacer |
|---|---|---|
| El nombre se rechaza como no válido | Está vacío, o no es un slug en minúsculas de letras, dígitos y guiones | Corrige el nombre |
| El nombre se rechaza porque ya está en uso | Un contexto vigente del tenant ya tiene ese nombre | Elige otro nombre |
Como máximo 120 caracteres. bajo el régimen regulatorio | El régimen tiene más de 120 caracteres | Acórtalo |
| Crear sigue sin estar disponible | El nombre está vacío, o un campo supera su límite de tamaño (lo muestra el contador bajo el campo) | Completa el nombre, o acorta el campo |
El contexto de intercambio no se puede eliminar mientras todavía tenga dependientes (Exchange Context cannot be deleted while it still has dependents: …) | Todavía hacen referencia al contexto concesiones de capacidad o intercambios activos; el mensaje los cuenta | Revoca los dependientes que nombra y vuelve a intentarlo |
Sin la consola
| Superficie | Cómo |
|---|---|
| CLI de gestión de claves | ankasecure-km exchange-contexts create --body-file <file>; exchange-contexts update --id <uuid> --body-file <file>; exchange-contexts delete --id <uuid> |
| Admin SDK | ExchangeContextOperations.create(CreateExchangeContextRequest), ExchangeContextOperations.update(UUID, UpdateExchangeContextRequest), ExchangeContextOperations.delete(UUID) |
| API | POST /api/v3/admin/tenants/{tenantId}/exchange-contexts (operación createExchangeContext); PATCH /api/v3/admin/tenants/{tenantId}/exchange-contexts/{contextId} (operación updateExchangeContext); DELETE /api/v3/admin/tenants/{tenantId}/exchange-contexts/{contextId} (operación deleteExchangeContext) |
Relacionado
- Contextos de Intercambio: qué muestra la pantalla y cada decisión que tomas en ella.
- Suspender, reanudar o cerrar un contexto de intercambio
- Diseñar, validar y activar un intercambio
Esta página está en inglés: