Autenticación y acceso

Aplica a: BarcoderX Basic y Ultimate

Estado: Planificado. Todavía no hay nada publicado y no hay nada que descargar. Esta página explica las ideas para el servidor de API que usted ejecuta. Los pasos exactos se escriben cuando se publique la API.

Quién llama

Cada llamada a la API web proviene de algo que su servidor puede identificar. Están previstos estos tipos de llamantes:

Llamante	Cómo demuestra quién es
Su programa	Envía una clave de API.
Un servicio suyo	Usa el flujo de credenciales de cliente de OAuth2.
Un agente de impresión	Firma una aserción de corta duración con su propia clave privada. Usted no programa esto. Consulte El agente de impresión.

La API está diseñada para no depender de un solo proveedor de identidad. Qué proveedores se admiten se confirma antes de la primera versión. También se definirá más adelante cómo inicia sesión una persona en una página que incorpora el editor de etiquetas.

Claves de API

Una clave de API permite que un programa llame a la API sin una persona.

Una clave tiene este aspecto: bx_<env>_<keyId>_<secret>. Usted la envía en el encabezado Authorization como un token de portador (bearer).
BarcoderX muestra la clave completa una sola vez, cuando la crea. Después guarda solamente una huella protegida de ella, por lo que no puede mostrarla de nuevo. Guárdela como guardaría una contraseña.
Una clave puede tener una lista de permisos, una fecha de vencimiento y una lista de direcciones IP permitidas.
BarcoderX nunca escribe una clave en un registro.

Permisos

Cada llamada necesita un permiso llamado ámbito (scope).

Ámbito	Qué permite
`templates.read`	Leer plantillas
`templates.write`	Crear y cambiar plantillas
`render`	Generar, exportar y crear comandos de impresora
`print`	Imprimir y leer trabajos de impresión
`assets.write`	Subir y eliminar fuentes e imágenes
`printers.manage`	Registrar impresoras, dar de alta agentes, ejecutar mantenimiento
`templates.raw`	Usar comandos de impresora sin procesar en una plantilla
`admin`	Claves de API y el registro de auditoría

El ámbito templates.raw nunca se concede de forma predeterminada.

Otras protecciones

Todo el tráfico usa HTTPS.
Cada cambio que alguien hace y cada evento de seguridad se escribe en un registro de auditoría.
Los trabajos de impresión y las fuentes de datos se cifran mientras están almacenados en su base de datos. Los trabajos de impresión se eliminan después de un periodo de retención.

BarcoderX es un producto de P4 Software.

¿Te resultó útil esta página?

Anterior API web Siguiente Ediciones y licencias