HMACContext

Inherits: RefCounted < Object

Used to create an HMAC for a message using a key.

Description

The HMACContext class is useful for advanced HMAC use cases, such as streaming the message as it supports creating the message over time rather than providing it all at once.

GDScriptC#

  1. extends Node
  2. var ctx = HMACContext.new()
  3. func _ready():
  4. var key = "supersecret".to_utf8_buffer()
  5. var err = ctx.start(HashingContext.HASH_SHA256, key)
  6. assert(err == OK)
  7. var msg1 = "this is ".to_utf8_buffer()
  8. var msg2 = "super duper secret".to_utf8_buffer()
  9. err = ctx.update(msg1)
  10. assert(err == OK)
  11. err = ctx.update(msg2)
  12. assert(err == OK)
  13. var hmac = ctx.finish()
  14. print(hmac.hex_encode())
  1. using Godot;
  2. using System.Diagnostics;
  3. public partial class MyNode : Node
  4. {
  5. private HmacContext _ctx = new HmacContext();
  6. public override void _Ready()
  7. {
  8. byte[] key = "supersecret".ToUtf8Buffer();
  9. Error err = _ctx.Start(HashingContext.HashType.Sha256, key);
  10. Debug.Assert(err == Error.Ok);
  11. byte[] msg1 = "this is ".ToUtf8Buffer();
  12. byte[] msg2 = "super duper secret".ToUtf8Buffer();
  13. err = _ctx.Update(msg1);
  14. Debug.Assert(err == Error.Ok);
  15. err = _ctx.Update(msg2);
  16. Debug.Assert(err == Error.Ok);
  17. byte[] hmac = _ctx.Finish();
  18. GD.Print(hmac.HexEncode());
  19. }
  20. }

Methods

PackedByteArray

finish ( )

Error

start ( HashType hash_type, PackedByteArray key )

Error

update ( PackedByteArray data )


Method Descriptions

PackedByteArray finish ( )

Returns the resulting HMAC. If the HMAC failed, an empty PackedByteArray is returned.


Error start ( HashType hash_type, PackedByteArray key )

Initializes the HMACContext. This method cannot be called again on the same HMACContext until finish has been called.


Error update ( PackedByteArray data )

Updates the message to be HMACed. This can be called multiple times before finish is called to append data to the message, but cannot be called until start has been called.

Previous Next


© Copyright 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision 53e837c6.

Built with Sphinx using a theme provided by Read the Docs.