Saltar al contenido principal
Una atestación firma una carga útil y registra su hash. La verificación comprueba la integridad criptográfica y el estado del registro; no establece de forma independiente que las afirmaciones del emisor sean verdaderas.

Antes de empezar

En Console, seleccione su espacio de trabajo y entorno. Obtenga una clave API, un ID de emisor y una clave activa disponible para la firma del lado del servidor. Utilice el algoritmo que se muestra para esa clave. El registro de una clave pública por sí solo no le da al servicio de firma su clave privada. Use https://sandbox-api.truthlocks.com con una clave de sandbox (tl_test_). Use https://api.truthlocks.com con una clave de producción (tl_live_) y un espacio de trabajo aprobado. Los recursos y las credenciales deben pertenecer al mismo entorno. No envíe X-Tenant-ID para elegir un espacio de trabajo: se deriva de sus credenciales.

Acuñar un registro

Este ejemplo utiliza la biblioteca estándar de Python 3. Establezca las cuatro variables de entorno requeridas a través de su shell o administrador de secretos. Establezca TRUTHLOCKS_BASE_URL solo si cambia de sandbox a producción.
Los errores HTTP generan urllib.error.HTTPError. Maneje los errores y los tiempos de espera en su aplicación; conserve la misma clave de idempotencia y cuerpo al reintentar un resultado de acuñación incierto. La respuesta utiliza attestation_id, issued_at_unix, signature y log. No repite las reclamaciones como un payload de nivel superior. Conserve los bytes originales para comprobaciones de integridad posteriores.

Verificar el resultado

Utilice la referencia de verificación con el attestation_id devuelto. Suministre payload_b64url para verificar los bytes originales exactos, o document_hash_hex para comparar un hash de archivo. Inspeccione verdict y reasons: una respuesta HTTP exitosa por sí sola no significa que el registro sea válido.

Solución de problemas

  • 401 o 403: verifique las credenciales, el entorno, los permisos y la aprobación del espacio de trabajo.
  • 400: verifique los UUID, el encabezado de idempotencia y la codificación base64url sin relleno.
  • Error de clave o política: confirme que el emisor y la clave se pueden usar para firmar y que el algoritmo coincide.
  • Tiempo de espera: reintente con el cuerpo original y la clave de idempotencia, en lugar de crear una nueva acuñación.
Continuar con parámetros de acuñación, autenticación, y entornos.