Skip to content

Definir una política de restricción para las concesiones

Crea, cambia o elimina un conjunto reutilizable de condiciones que limita cómo se pueden usar las concesiones de capacidad: cuándo, en qué días y horas, cuántas veces, con qué frecuencia y si solo una vez.

Quién puede hacerlo

Un administrador del tenant o un gestor de claves del tenant. Crear, editar y eliminar una política son permisos distintos; la consola muestra Nueva política de restricción, Editar y Eliminar solo a una persona que tiene el permiso correspondiente.

Esto es para los tenants que componen la autorización a mano. Un tenant SIMPLE usa en su lugar los Casos de Uso Internos, y la plataforma le rechaza estos cambios.

Antes de empezar

  • Una política no restringe nada por sí sola: surte efecto mediante las concesiones fijadas a una de sus versiones.
  • Los recuentos de uso se llevan por concesión. Dos concesiones con la misma política tienen cada una su propia asignación.
  • Los días y las horas se leen en la zona horaria de la plataforma, que establece un administrador de la plataforma.

Pasos

  1. Abre Políticas de restricción desde la barra lateral del tenant.
  2. Para crear una política, selecciona Nueva política de restricción:
    1. Escribe un Nombre y, de forma opcional, una Descripción.
    2. Establece las condiciones que necesites. Cada condición es opcional, y un uso debe cumplirlas todas:
      • Válida desde y Válida hasta: la ventana en la que funciona una concesión, en tu zona horaria de visualización; cualquiera de los dos extremos puede quedar abierto.
      • Horario: marca Admitir solicitudes solo en los días y horas elegidos y luego elige los Días y las horas Desde y Hasta.
      • Uso máximo: cuántos usos se permiten a cada concesión. En blanco significa ilimitado.
      • Límite de frecuencia: usos por minuto para cada concesión. En blanco significa sin límite; 0 bloquea todos los usos.
      • Revocar al usar: el primer uso consume la concesión.
    3. Selecciona Crear.
  3. Para cambiar una política, selecciónala, selecciona Editar en su pestaña Información, cambia los campos y selecciona Guardar cambios.
  4. Para eliminar una política, selecciónala, selecciona Eliminar en su pestaña Información y confirma con Eliminar.

Qué ves cuando funcionó

  • Crear: la consola confirma que se creó la política. Se lista con la versión 1, y el asistente de concesiones la ofrece.
  • Editar: la consola confirma que se actualizó la política. Al guardar se escribe la versión siguiente; la columna Versión la muestra, y la pestaña Versiones lista todas las versiones. Una edición no mueve ninguna concesión: una concesión conserva la versión a la que se fijó hasta que se vuelva a fijar con Cambiar versión.
  • Eliminar: la consola confirma que se eliminó la política. Una política eliminada no se puede restaurar.

Cada cambio se registra en la traza de auditoría; la pestaña Actividad de la política lo muestra.

Si falla

Qué ves Causa Qué hacer
Se rechaza la eliminación, nombrando las concesiones que tienen la política Una concesión de capacidad o un intercambio criptográfico todavía la referencian Revoca esas concesiones o vuelve a fijarlas a otra política, y luego elimínala
Se rechaza la ventana de validez Válida hasta no es posterior a Válida desde Corrige las fechas
Se rechaza un Uso máximo o un Límite de frecuencia negativo Ambos deben ser cero o más Escribe cero o más, o deja el campo en blanco
"Elige al menos un día." Un horario no nombra ningún día Elige los días, o desmarca el horario
"Ingresa una hora de inicio y una de fin." Un horario tiene solo una de sus horas Escribe ambas horas
"El inicio y el fin deben ser distintos." El horario empieza y termina a la misma hora Cambia una de ellas. Un fin anterior al inicio se extiende hasta el día siguiente
"No se pudo guardar la política" El servidor rechazó la política sin un detalle que la consola pueda mostrar Revisa las condiciones y vuelve a intentarlo

Sin la consola

Superficie Cómo
CLI de gestión de claves ankasecure-km constraint-policies create --body-file <json>, ankasecure-km constraint-policies update --id <uuid> --body-file <json> y ankasecure-km constraint-policies delete --id <uuid>
Admin SDK ConstraintPolicyOperations.create(CreateConstraintPolicyRequest), update(UUID, CreateConstraintPolicyRequest) y delete(UUID)
API POST /api/v3/admin/tenants/{tenantId}/constraint-policies (operación createConstraintPolicy)
API PATCH /api/v3/admin/tenants/{tenantId}/constraint-policies/{policyId} (operación updateConstraintPolicy)
API DELETE /api/v3/admin/tenants/{tenantId}/constraint-policies/{policyId} (operación deleteConstraintPolicy)

Relacionado